@@ -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