AGENTS KNOWLEDGE BASE

OVERVIEW

Main plugin entry point and orchestration layer. Plugin initialization, hook registration, tool composition, and lifecycle management.

Core Responsibilities:

Plugin initialization via OhMyOpenCodePlugin() factory
Hook registration: createCoreHooks(), createContinuationHooks(), createSkillHooks()
Tool composition with filtering
Background agent management via BackgroundManager
MCP lifecycle via SkillMcpManager

STRUCTURE

src/
├── index.ts                          # Main plugin entry (999 lines)
├── create-hooks.ts                   # Hook coordination: core, continuation, skill
├── plugin-config.ts                  # Config loading orchestration
├── plugin-state.ts                   # Model cache state
├── agents/                           # 11 AI agents (20 files) - see agents/AGENTS.md
├── cli/                              # CLI installer, doctor (100+ files) - see cli/AGENTS.md
├── config/                           # Zod schema (21 files) - see config/AGENTS.md
├── features/                         # Background agents, skills, commands (17 dirs) - see features/AGENTS.md
├── hooks/                            # 40+ lifecycle hooks (30+ dirs) - see hooks/AGENTS.md
├── mcp/                              # Built-in MCPs (8 files) - see mcp/AGENTS.md
├── plugin/                           # Plugin SDK types
├── plugin-handlers/                  # Plugin config loading (5 files) - see plugin-handlers/AGENTS.md
├── shared/                           # Cross-cutting utilities (84 files) - see shared/AGENTS.md
└── tools/                            # 25+ tools (14 dirs) - see tools/AGENTS.md

KEY COMPONENTS

Plugin Initialization:

OhMyOpenCodePlugin(): Main plugin factory
Configuration loading via loadPluginConfig()
Hook registration with safe creation patterns
Tool composition and disabled tool filtering

Lifecycle Management:

40+ hooks: session recovery, continuation enforcers, compaction, context injection
Background agent coordination via BackgroundManager
Tmux session management for multi-pane workflows
MCP server lifecycle via SkillMcpManager

Tool Ecosystem:

25+ tools: LSP, AST-grep, delegation, background tasks, skills
Tool filtering based on agent permissions and user config
Metadata restoration for tool outputs

HOOK REGISTRATION

Safe Hook Creation:

const hook = isHookEnabled("hook-name")
  ? safeCreateHook("hook-name", () => createHookFactory(ctx), { enabled: safeHookEnabled })
  : null;

Hook Categories:

Session Management: recovery, notification, compaction
Continuation: todo/task enforcers, stop guards
Context: injection, rules, directory content
Tool Enhancement: output truncation, error recovery
Agent Coordination: usage reminders, babysitting, delegation

TOOL COMPOSITION

const allTools: Record<string, ToolDefinition> = {
  ...builtinTools,
  ...createGrepTools(ctx),
  ...createAstGrepTools(ctx),
  task: delegateTask,
  skill: skillTool,
};

Filtering: Agent permissions, user disabled_tools, session state.

LIFECYCLE FLOW

User message triggers agent selection
Model/variant resolution applied
Tools execute with hook interception
Continuation enforcers monitor completion
Session compaction preserves context

3.4 KiB Raw Blame History