From 85cafe55b23c490427101ccea5b2635b8a5a4784 Mon Sep 17 00:00:00 2001 From: Minsu Lee Date: Sat, 11 Jul 2026 19:47:17 +0900 Subject: [PATCH 1/2] docs: correct the `csp --agent` list in CLAUDE.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Public API surface listed `--agent `, which drifted from the actual `Agent` clap ValueEnum in src/bin/csp/main.rs on two counts: - it advertised `codex`, which is NOT a valid `--agent` value (clap rejects it) — Codex is supported via the plugin / MCP `~/.codex/config.toml`, not an `init`-generated agent file; - it omitted csp's own agents: antigravity, commandcode, kiro, pi, reasonix. Sync the list to the real enum and note the Codex distinction. The README's `csp init --agent` examples were already correct. Refs #76 --- CLAUDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 970e6c7..f239726 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -61,7 +61,7 @@ bun run lint:fix # eslint . --fix --cache These names are **load-bearing** — they appear in the README's MCP configs, CLI examples, and library usage block, and external users will install against them. Don't rename without updating both READMEs. - **Library**: `CspIndex` (parallels `SembleIndex`) with `.fromPath()`, `.fromGit()`, `.search()`, `.findRelated()`, `.save()`, `.loadFromDisk()`. Enum `ContentType` with `CODE | DOCS | CONFIG`. Camel-cased fields: `chunk.filePath`, `chunk.startLine`, `chunk.endLine`. -- **CLI** (`csp`): `search`, `index`, `find-related`, `mcp`, `init`, `savings`. Flags: `--top-k`, `--content {code|docs|config|all}`, `--index `, `--agent `. +- **CLI** (`csp`): `search`, `index`, `find-related`, `mcp`, `init`, `savings`. Flags: `--top-k`, `--content {code|docs|config|all}`, `--index `, `--agent ` (the `Agent` clap `ValueEnum` in `src/bin/csp/main.rs`; **Codex is not an `init` agent** — it's wired via the plugin / MCP `~/.codex/config.toml`, see README). - **MCP tools**: `search`, `find_related`. Server launched via `bunx @pleaseai/csp mcp` (note `mcp` subcommand — semble uses the bare binary). - **Stats path**: `~/.csp/savings.jsonl` (semble uses `~/.semble/`). The global index cache lives alongside it at `~/.csp/index/` (per [ADR 0002](.please/docs/decisions/0002-index-storage-cache-model.md)); `csp clear index` removes only that directory. From 9380337c5af98fbda7517aada93fe540fb54e7c5 Mon Sep 17 00:00:00 2001 From: Minsu Lee Date: Sun, 12 Jul 2026 02:28:45 +0900 Subject: [PATCH 2/2] chore: apply AI code review suggestions --- CLAUDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index f239726..7ead4f7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -61,7 +61,7 @@ bun run lint:fix # eslint . --fix --cache These names are **load-bearing** — they appear in the README's MCP configs, CLI examples, and library usage block, and external users will install against them. Don't rename without updating both READMEs. - **Library**: `CspIndex` (parallels `SembleIndex`) with `.fromPath()`, `.fromGit()`, `.search()`, `.findRelated()`, `.save()`, `.loadFromDisk()`. Enum `ContentType` with `CODE | DOCS | CONFIG`. Camel-cased fields: `chunk.filePath`, `chunk.startLine`, `chunk.endLine`. -- **CLI** (`csp`): `search`, `index`, `find-related`, `mcp`, `init`, `savings`. Flags: `--top-k`, `--content {code|docs|config|all}`, `--index `, `--agent ` (the `Agent` clap `ValueEnum` in `src/bin/csp/main.rs`; **Codex is not an `init` agent** — it's wired via the plugin / MCP `~/.codex/config.toml`, see README). +- **CLI** (`csp`): `search`, `index`, `find-related`, `mcp`, `init`, `savings`. Flags: `--top-k`, `--content {code|docs|config|all}`, `--index `, `--agent ` (the `Agent` clap `ValueEnum` in `crates/csp/src/bin/csp/main.rs`; **Codex is not an `init` agent** — it's wired via the plugin / MCP `~/.codex/config.toml`, see README). - **MCP tools**: `search`, `find_related`. Server launched via `bunx @pleaseai/csp mcp` (note `mcp` subcommand — semble uses the bare binary). - **Stats path**: `~/.csp/savings.jsonl` (semble uses `~/.semble/`). The global index cache lives alongside it at `~/.csp/index/` (per [ADR 0002](.please/docs/decisions/0002-index-storage-cache-model.md)); `csp clear index` removes only that directory.