Files
oh-my-openagent/src/features/AGENTS.md
YeonGyu-Kim a1fe0f8517 docs(agents): regenerate all AGENTS.md files with comprehensive codebase analysis
- Regenerated root AGENTS.md with overview, structure, and complexity hotspots
- Regenerated all 7 subdirectory AGENTS.md files: hooks, tools, features, agents, cli, auth, shared
- Used 11 background explore agents for comprehensive feature and architecture analysis
- All files within size limits (root: 112 lines, subdirs: 57-68 lines)
- Includes where-to-look guide, conventions, anti-patterns, and agent model information

🤖 Generated with assistance of oh-my-opencode
2026-01-02 10:42:38 +09:00

2.2 KiB

FEATURES KNOWLEDGE BASE

OVERVIEW

Claude Code compatibility layer + core feature modules. Commands, skills, agents, MCPs, hooks from Claude Code work seamlessly.

STRUCTURE

features/
├── background-agent/           # Task lifecycle, notifications (460 lines)
├── builtin-commands/           # Built-in slash commands
├── builtin-skills/             # Built-in skills (playwright)
├── claude-code-agent-loader/   # ~/.claude/agents/*.md
├── claude-code-command-loader/ # ~/.claude/commands/*.md
├── claude-code-mcp-loader/     # .mcp.json files
│   └── env-expander.ts         # ${VAR} expansion
├── claude-code-plugin-loader/  # installed_plugins.json (484 lines)
├── claude-code-session-state/  # Session state persistence
├── opencode-skill-loader/      # Skills from OpenCode + Claude paths
├── skill-mcp-manager/          # MCP servers in skill YAML
└── hook-message-injector/      # Inject messages into conversation

LOADER PRIORITY

Loader Priority (highest first)
Commands .opencode/command/ > ~/.config/opencode/command/ > .claude/commands/ > ~/.claude/commands/
Skills .opencode/skill/ > ~/.config/opencode/skill/ > .claude/skills/ > ~/.claude/skills/
Agents .claude/agents/ > ~/.claude/agents/
MCPs .claude/.mcp.json > .mcp.json > ~/.claude/.mcp.json

CONFIG TOGGLES

{
  "claude_code": {
    "mcp": false,      // Skip .mcp.json
    "commands": false, // Skip commands/*.md
    "skills": false,   // Skip skills/*/SKILL.md
    "agents": false,   // Skip agents/*.md
    "hooks": false     // Skip settings.json hooks
  }
}

BACKGROUND AGENT

  • Lifecycle: pending → running → completed/failed
  • OS notification on complete
  • background_output to retrieve results
  • background_cancel with task_id or all=true

SKILL MCP

  • MCP servers embedded in skill YAML frontmatter
  • Lazy client loading, session-scoped cleanup
  • skill_mcp tool exposes capabilities

ANTI-PATTERNS

  • Blocking on load (loaders run at startup)
  • No error handling (always try/catch)
  • Ignoring priority order
  • Writing to ~/.claude/ (read-only)