xonecas.io
687
Oc

orc-code / commit 364cb12

docs: update AGENTS.md repo structure for core/cli split

xonecas2026-03-26 364cb12c76b17642923784fb23e16b7165dee427 parent 87e4b22

1 file changed

AGENTS.md+7−4
@@ -99,23 +99,26 @@ Bun workspace monorepo. The core CLI and each agent plugin are separate packages
9999 ```
100100 orc-code/
101101 ├── packages/
102-│ ├── orc-core/ # CLI entrypoint, session management, UI, SQLite
102+│ ├── orc-core/ # Core library: agent discovery, session DB, plugin registry
103103 │ │ ├── src/
104-│ │ └── package.json # name: "orc-code", bin: { "orc": ... }
104+│ │ └── package.json # name: "orc-code"
105+│ ├── orc-cli/ # CLI interface: entrypoint, prompt, display
106+│ │ ├── src/
107+│ │ └── package.json # name: "@orc-code/cli", bin: { "orc": ... }
105108 │ ├── plugin-claude/ # Claude Code agent plugin
106109 │ │ ├── src/
107110 │ │ └── package.json # name: "@orc-code/plugin-claude"
108111 │ ├── plugin-codex/ # Codex agent plugin
109112 │ │ ├── src/
110113 │ │ └── package.json # name: "@orc-code/plugin-codex"
111-│ └── types/ # Shared types (AgentPlugin, AgentEvent, AgentProcess)
114+│ └── types/ # Shared types (AgentPlugin, AgentEvent, AgentProcess) and helpers
112115 │ ├── src/
113116 │ └── package.json # name: "@orc-code/types"
114117 ├── package.json # workspaces: ["packages/*"]
115118 └── biome.json
116119 ```
117120
118-`@orc-code/types` is the plugin contract as a standalone package — third-party plugin authors depend on it and nothing else. The core `orc` package depends on the builtin plugins and wires everything together. Bun workspaces handle linking and resolution across packages.
121+`@orc-code/types` is the plugin contract as a standalone package — third-party plugin authors depend on it and nothing else. `orc-code` (core) is a headless library that owns agent discovery, session persistence, and plugin registration — it has no terminal I/O. `@orc-code/cli` is the terminal interface that imports the core and provides the interactive UX. This separation allows other UIs (TUI, web, editor extensions) to build on the same core. Bun workspaces handle linking and resolution a …
119122
120123 ## UX/UI