Skip to content

Commit 20af711

Browse files
committed
chore: Update CLAUDE.md
1 parent c8fabf4 commit 20af711

1 file changed

Lines changed: 17 additions & 4 deletions

File tree

CLAUDE.md

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ npm run lint # ESLint
1313
npm run typecheck # TypeScript (root + src/webui/tsconfig.json)
1414
npm run build:ui # Build the web UI bundle (Vite); runs automatically as part of `build`
1515
npm run dev:ui # Vite dev server for the web UI
16+
npm run dev:kill # Kill the running daemon (re-run before `npm run dev`)
17+
npm run lint:fix # ESLint with --fix
18+
npm run build:ui:submodule # Build web UI from the local submodule (vs default published package)
19+
npm run dev:ui:package # Vite dev server resolving shared UI from the installed package
1620
./bin/dev.js [command] # Dev mode (ts-node)
1721
./bin/run.js [command] # Prod mode
1822
```
@@ -57,8 +61,8 @@ npm run dev:ui # Vite dev server for the web UI
5761

5862
### Source Layout (`src/`)
5963

60-
- `agent/` — LLM agent: `core/` (interfaces/domain), `infra/` (23 modules, including llm, memory, map, swarm, tools, document-parser), `resources/` (prompts YAML, tool `.txt` descriptions)
61-
- `server/` — Daemon infrastructure: `config/`, `core/` (domain/interfaces), `infra/` (31 modules, including vc, git, hub, mcp, cogit, project, provider-oauth, space, dream, webui), `templates/`, `utils/`
64+
- `agent/` — LLM agent: `core/` (interfaces/domain), `infra/` (modules including llm, memory, map, swarm, sandbox, session, tools, document-parser), `resources/` (prompts YAML, tool `.txt` descriptions)
65+
- `server/` — Daemon infrastructure: `config/`, `core/` (domain/interfaces), `infra/` (modules including vc, git, hub, mcp, cogit, connectors, project, provider-oauth, session, space, dream, webui), `templates/`, `utils/`
6266
- `shared/` — Cross-module: constants, types, transport events, utils
6367
- `tui/` — React/Ink TUI: app (router/pages), components, features (23 modules, including vc, worktree, source, hub, curate), hooks, lib, providers, stores
6468
- `webui/` — Browser dashboard (React/Vite). Entry `src/webui/index.tsx`; `features/` (15 panels), `pages/` (8 pages: home, changes, configuration, contexts, tasks, analytics, project-selector, not-found), `layouts/`, `stores/`. Connects to the daemon via Socket.IO; no imports from `server/`, `agent/`, or `tui/` (same boundary rule)
@@ -89,7 +93,7 @@ npm run dev:ui # Vite dev server for the web UI
8993

9094
### VC, Worktrees & Knowledge Sources
9195

92-
- `brv vc` — isomorphic-git version control (add, branch, checkout, clone, commit, config, diff, fetch, init, log, merge, pull, push, remote, reset, status); git plumbing in `server/infra/git/` (`isomorphic-git-service.ts`), VC config store in `server/infra/vc/`
96+
- `brv vc` — isomorphic-git version control (add, branch, checkout, clone, commit, config, diff, fetch, init, log, merge, pull, push, `remote add|remove|set-url`, reset, status); git plumbing in `server/infra/git/` (`isomorphic-git-service.ts`), VC config store in `server/infra/vc/`
9397
- `brv worktree` (add/list/remove) — git-style worktree pointer model: `.brv/` is either a real project directory OR a pointer file to a parent project; parent stores registry in `.brv/worktrees/<name>/link.json`
9498
- `brv source` (add/list/remove) — link another project's context tree as a read-only knowledge source with write isolation
9599
- `brv search <query>` — pure BM25 retrieval over the context tree (minisearch, no LLM, no token cost); structured results with paths/scores. Pairs with `brv query` (LLM-synthesized answer). Engine: `server/infra/executor/search-executor.ts`
@@ -105,11 +109,20 @@ npm run dev:ui # Vite dev server for the web UI
105109
- `brv review [--disable | --enable]` — toggle the project-scoped HITL review log; `brv review pending` lists items, `brv review approve <id>` / `brv review reject <id>` resolve them. When disabled, sync curate skips the "X operations require review" prompt, detached curate stops emitting per-operation review markers, and `brv dream` no longer surfaces `needsReview` operations. The flag is snapshotted at task creation and propagated via `AsyncLocalStorage` (`resolveReviewDisabled`) so mid-task toggles do not race
106110
- `brv login` defaults to OAuth (interactive provider picker); pass `--api-key` only for CI. `brv logout` clears credentials
107111

112+
### Other oclif topic groups
113+
114+
- `brv hub install | list | registry (add|list|remove)` — Context Hub (npm-style package manager for context); registry config is per-project
115+
- `brv space list | switch` — Context Hub spaces (team/space scoping)
116+
- `brv connectors install | list` — agent-side connector plugins (e.g., OpenClaude registered as a connector)
117+
- `brv model list | switch` — pick the LLM model for the active provider
118+
- `brv providers connect | disconnect | list | switch` — provider OAuth / API-key management
119+
- `brv curate view` — read-only inspect of a curate operation; the main curate entry is the REPL slash command
120+
108121
### Agent (`src/agent/`)
109122

110123
- Tools: definitions in `resources/tools/*.txt`, implementations in `infra/tools/implementations/`, registry in `infra/tools/tool-registry.ts`
111124
- Tool categories: file ops (read/write/edit/glob/grep/list-dir), bash (exec/output), knowledge (create/expand/search), memory (read/write/edit/delete/list), swarm (query/store), todos (read/write), curate, code exec, batch, detect domains, kill process, search history
112-
- LLM: 21 providers in `infra/llm/providers/` (incl. deepseek, glm, glm-coding-plan); compression strategies in `infra/llm/context/compression/`
125+
- LLM: 20 providers in `infra/llm/providers/` (incl. deepseek, glm, glm-coding-plan); compression strategies in `infra/llm/context/compression/`
113126
- System prompts: contributor pattern (XML sections) in `infra/system-prompt/`
114127
- Map/memory: `infra/map/` (agentic map, context-tree store, LLM map memory, worker pool); `infra/memory/` (memory-manager, deduplicator)
115128
- Storage: file-based blob (`infra/blob/`) and key storage (`infra/storage/`) — no SQLite

0 commit comments

Comments
 (0)