AGENTS.md

1# claude-code-compat-core — Claude Code Compatibility Loaders (Core)
2 
3**Generated:** 2026-06-16
4 
5[packages/AGENTS.md](../AGENTS.md)
6 
7## OVERVIEW
8 
9Harness-neutral Core that discovers and translates Claude Code plugins, commands, agents, skills, and MCP configs into structures that harness adapters can consume.
10 
11Npm package: `@oh-my-opencode/claude-code-compat-core`. Barrel-exported from `src/index.ts`. Consumed by `omo-opencode` via thin shim re-exports under [`packages/omo-opencode/src/features/claude-code-*/`](../omo-opencode/src/features/).
12 
13Type-check with `bun run typecheck` (tsgo). Tests are co-located as `*.test.ts` inside each feature dir.
14 
15## LOADERS
16 
17| Feature dir | What it loads | Key entry |
18|-------------|---------------|-----------|
19| `claude-code-plugin-loader/` | Claude Code plugins (commands, skills, agents, MCP servers, hooks) | `loader.ts` (`PluginComponentsResult`) |
20| `claude-code-mcp-loader/` | `.mcp.json` configs (user/project/local) into OpenCode SDK format | `loader.ts` |
21| `claude-code-command-loader/` | Slash commands from markdown files in project and config dirs | `loader.ts` |
22| `claude-code-agent-loader/` | Agent definitions from markdown and JSON configs | `loader.ts` |
23 
24## SHARED
25 
26`src/shared/` has 17 barrel-exported helpers for config-dir resolution, frontmatter parsing, model sanitization, path resolution, and Bun shims. Key entry: `shared/index.ts`.
27 
28## NOTES
29 
30- **Env allowlist:** The MCP loader expands `${VAR}` placeholders only for variables listed in `mcp_env_allowlist` (user-only, security). Implemented in `env-expander.ts` and `configure-allowed-env-vars.ts`.
31- **Scope filtering:** Both plugin and MCP loaders filter by scope (`user`/`project`/`local`). See `scope-filter.ts` in each loader dir.
32- **Plugin discovery:** `discovery.ts` walks Claude Code plugin directories; `plugin-path-resolver.ts`, `install-path-resolver.ts`, and `plugin-manifest.ts` map installed artifacts to loadable structures.
33