Skip to content

Commit 6df7fcb

Browse files
authored
Merge pull request #2906 from davidwed/agentty-install
feat: add agentty agent support to the install CLI
2 parents 822e7fc + e7c205a commit 6df7fcb

11 files changed

Lines changed: 312 additions & 28 deletions

File tree

‎README.md‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
[![MCP tools](https://img.shields.io/badge/MCP_tools-17-blue)](#mcp-tools)
88
[![Languages](https://img.shields.io/badge/languages-162-orange)](https://github.com/DeusData/codebase-memory-mcp)
99
[![Hybrid LSP](https://img.shields.io/badge/Hybrid_LSP-type_resolution-blue)](#hybrid-lsp)
10-
[![Agents](https://img.shields.io/badge/agent_surfaces-45-purple)](https://github.com/DeusData/codebase-memory-mcp)
10+
[![Agents](https://img.shields.io/badge/agent_surfaces-46-purple)](https://github.com/DeusData/codebase-memory-mcp)
1111
[![Pure C](https://img.shields.io/badge/pure_C-no_language_runtime-blue)](https://github.com/DeusData/codebase-memory-mcp)
1212
[![Platform](https://img.shields.io/badge/macOS_%7C_Linux_%7C_Windows-supported-lightgrey)](https://github.com/DeusData/codebase-memory-mcp/releases/latest)
1313
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/DeusData/codebase-memory-mcp/badge)](https://scorecard.dev/viewer/?uri=github.com/DeusData/codebase-memory-mcp)
@@ -20,7 +20,7 @@
2020

2121
Give your coding agent structural context through [Model Context Protocol](https://modelcontextprotocol.io/) (MCP), or query the graph directly from the CLI. **The MCP server is the core of the project.** Its optional visual companion, **CBM Lens, is in open beta (v0.0.1)**, with a source reader, architecture maps, the Galaxy graph, coverage diagnostics, architecture decisions, and local code chat.
2222

23-
The native C backend exposes **17 MCP tools**, parses [languages and file formats](#language-support) with vendored grammars, and adds [Hybrid LSP](#hybrid-lsp) type resolution for supported languages. The installer supports **45 automatic or conditional client integrations**, including client configuration, skills, agent profiles, and applicable hooks. Indexing and graph queries need no hosted service or API key. Focused graph queries can reduce repeated file reads and token use; see the [measured results](#performance).
23+
The native C backend exposes **17 MCP tools**, parses [languages and file formats](#language-support) with vendored grammars, and adds [Hybrid LSP](#hybrid-lsp) type resolution for supported languages. The installer supports **46 automatic or conditional client integrations**, including client configuration, skills, agent profiles, and applicable hooks. Indexing and graph queries need no hosted service or API key. Focused graph queries can reduce repeated file reads and token use; see the [measured results](#performance).
2424

2525
[Quick start](#quick-start) · [Capabilities](#features) · [Documentation](#documentation-connected-to-code) · [Infrastructure](#infrastructure-and-deployment) · [Smart CI](#smart-ci-and-test-impact) · [Explore CBM Lens](#cbm-lens-beta-code-visualization-and-source-navigation) · [Agent setup](#agent-setup-skills-profiles-and-hooks) · [MCP tools](#mcp-tools)
2626

@@ -701,7 +701,7 @@ Restart your agent. Verify with `/mcp`; you should see `codebase-memory-mcp` wit
701701

702702
## Multi-Agent Support
703703

704-
`install` configures **45 supported automatic/conditional client surfaces**: 39 detected automatically and 6
704+
`install` configures **46 supported automatic/conditional client surfaces**: 40 detected automatically and 6
705705
conditional or explicit. “Conditional” means the installer writes only when the
706706
documented platform or an explicit, already-existing config path proves the
707707
target is active. It never flips experimental feature flags, enables plugins,
@@ -768,6 +768,7 @@ overwrite user-modified agents.
768768
| Pi | Detected | none | `~/.pi/agent/AGENTS.md` + skill; MCP/subagents require an explicit reviewed extension |
769769
| IBM Bob IDE | Conditional | Existing `~/.bob/mcp.json` | Shared rule + IDE skill; no invented hook or agent |
770770
| Oh My Pi (omp) | Detected | Effective agent directory (`OMP_PROFILE` / `PI_CODING_AGENT_DIR`; default `~/.omp/agent/mcp.json`) | Skill and three direct-MCP graph-tool subagents (Scout/Verify/Auditor); preserves user `AGENTS.md` |
771+
| agentty | Detected | `~/.agentty/mcp.json` (overridden by `$AGENTTY_MCP_CONFIG`) | Skill in `~/.agentty/skills` (Claude-compatible SKILL.md) |
771772
| Sourcegraph Cody | Explicit opt-in | Existing `$CBM_CODY_CONFIG_PATH` | MCP only |
772773

773774
For Codex, install keeps only a tiny managed activation pointer in global
@@ -1147,7 +1148,7 @@ src/
11471148
main.c Entry point (MCP stdio server + CLI + install/update/config)
11481149
daemon/ Per-account session coordination, IPC, lifecycle, shared jobs/watchers
11491150
mcp/ MCP server (17 tools, JSON-RPC 2.0, session detection, auto-index)
1150-
cli/ Install/uninstall/update/config (45 client surfaces, hooks, instructions)
1151+
cli/ Install/uninstall/update/config (46 client surfaces, hooks, instructions)
11511152
store/ SQLite graph storage (nodes, edges, traversal, search, Louvain)
11521153
pipeline/ Multi-pass indexing (structure → definitions → calls → HTTP links → config → tests)
11531154
cypher/ Cypher query lexer, parser, planner, executor

‎docs/index.html‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@
7171
"Cross-service and cross-repository linking",
7272
"Change impact, coverage diagnostics and optional runtime trace ingestion",
7373
"Experimental C/C++ test selection using static relationships and admitted per-test coverage",
74-
"45 automatic/conditional client surfaces with client-specific setup",
74+
"46 automatic/conditional client surfaces with client-specific setup",
7575
"Optional browser AI with on-device inference"
7676
],
7777
"author": {
@@ -363,7 +363,7 @@ <h1>Understand the<br><span>whole repository.</span></h1>
363363
<div class="facts" aria-label="Project at a glance">
364364
<div><strong>One connected graph</strong><span>Source, docs and infrastructure</span></div>
365365
<div><strong>17 MCP tools</strong><span>Plus native CLI access</span></div>
366-
<div><strong>45 client surfaces</strong><span>Automatic or conditional setup</span></div>
366+
<div><strong>46 client surfaces</strong><span>Automatic or conditional setup</span></div>
367367
<div><strong>Local processing</strong><span>Your index stays on your machine</span></div>
368368
</div>
369369
</section>
@@ -426,14 +426,14 @@ <h1>Understand the<br><span>whole repository.</span></h1>
426426
</section>
427427

428428
<section class="section" id="integrations">
429-
<div class="section-head"><div><p class="eyebrow">Agent setup</p><h2>Context that fits<br>your coding workflow.</h2></div><p>The installer configures 45 automatic/conditional client surfaces. MCP connections, instructions, skills, profiles and hooks are installed according to each client's supported capabilities.</p></div>
429+
<div class="section-head"><div><p class="eyebrow">Agent setup</p><h2>Context that fits<br>your coding workflow.</h2></div><p>The installer configures 46 automatic/conditional client surfaces. MCP connections, instructions, skills, profiles and hooks are installed according to each client's supported capabilities.</p></div>
430430
<div class="integration-flow">
431431
<div class="integration-step"><span class="number">01 / CONNECT</span><strong>Set up your clients</strong><p>Configure supported integrations for clients such as Claude Code, Codex CLI, Gemini CLI, Cursor, Zed and OpenCode.</p></div>
432432
<div class="integration-step"><span class="number">02 / GUIDE</span><strong>Give agents a working method</strong><p>Skills and instructions guide graph queries, coverage checks and source verification. Supported custom-agent formats get Scout, Verify and Auditor profiles.</p></div>
433433
<div class="integration-step"><span class="number">03 / MAINTAIN CONTEXT</span><strong>Use supported hooks</strong><p>Client-specific lifecycle and read/search hooks help surface relevant graph context. Hook and subagent capabilities differ by client and platform.</p></div>
434434
</div>
435435
<details><summary>See the supported clients and integration boundaries</summary>
436-
<p><strong>Detected automatically (39):</strong> Claude Code, Codex CLI, Gemini CLI, Zed, OpenCode, Antigravity, Aider, KiloCode, VS Code, Cursor, Windsurf, Augment / Auggie, OpenClaw, Kiro, Junie, Hermes, OpenHands, Cline, Warp, Qwen Code, GitHub Copilot CLI, Factory Droid, Crush, Goose, Mistral Vibe, Grok Build, Qoder CLI, Kimi Code CLI, GitLab Duo CLI, Rovo Dev CLI, Amp, Devin CLI / Local, Tabnine, Amazon Q Developer IDE, CodeBuddy Code CLI, IBM Bob Shell, Pochi, Pi, and Oh My Pi (omp).</p>
436+
<p><strong>Detected automatically (40):</strong> Claude Code, Codex CLI, Gemini CLI, Zed, OpenCode, Antigravity, Aider, KiloCode, VS Code, Cursor, Windsurf, Augment / Auggie, OpenClaw, Kiro, Junie, Hermes, OpenHands, Cline, Warp, Qwen Code, GitHub Copilot CLI, Factory Droid, Crush, Goose, Mistral Vibe, Grok Build, Qoder CLI, Kimi Code CLI, GitLab Duo CLI, Rovo Dev CLI, Amp, Devin CLI / Local, Tabnine, Amazon Q Developer IDE, CodeBuddy Code CLI, IBM Bob Shell, Pochi, Pi, Oh My Pi (omp), and agentty.</p>
437437
<p><strong>Conditional or explicit (6):</strong> Continue / cn, Visual Studio, TRAE, Roo Code, IBM Bob IDE, and Sourcegraph Cody.</p>
438438
<p>These are client surfaces, not a promise of identical MCP, hook or subagent support. For example, Pi receives instructions and a skill; Warp's detected skill installation is counted while its MCP connection remains manual. Other manual, UI, cloud and repository-managed integrations are documented separately.</p>
439439
<p><a href="https://github.com/DeusData/codebase-memory-mcp#agent-setup-skills-profiles-and-hooks">Review the client matrix and setup details →</a></p>

‎docs/llms.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,14 +14,14 @@
1414
- Smart CI (experimental): repository-specific changed-file rules select CI jobs; test-impact select combines static reachability, changed tests, and admitted per-test coverage to select tests. Narrowing supports C/C++ family code with supported test-harness conventions and an explicitly configured runner. Missing or doubtful evidence broadens the selection or runs all tests. Other indexed languages are not automatically supported for test narrowing. test-impact publish creates the baseline graph-and-coverage bundle. Start in shadow mode; consult the guide for version requirements.
1515
- Architecture decisions and runtime evidence: manage_adr stores the project's decision record; ingest_traces adds separately collected observed call relationships alongside static analysis.
1616
- CBM Lens open beta (v0.0.1): optional visual companion to the MCP server, with a local browser interface with source exploration, Galaxy graph navigation, architecture and behavior views, ADR editing, index-coverage diagnostics, daemon/system information, and optional local code chat. Static graph animations are not live execution traces. Activity overlays are experimental source-build features, not a standard-release promise.
17-
- Agent integrations: 45 automatic or conditional client surfaces. Installation configures supported MCP entries, durable instructions, skills, Scout/Verify/Auditor profiles, and applicable session, compaction, search, and read hooks. Coverage and activation vary by client and platform. Hooks provide context without blocking or replacing the user's tool call; some clients require trust or use parent-agent handoff instead.
17+
- Agent integrations: 46 automatic or conditional client surfaces. Installation configures supported MCP entries, durable instructions, skills, Scout/Verify/Auditor profiles, and applicable session, compaction, search, and read hooks. Coverage and activation vary by client and platform. Hooks provide context without blocking or replacing the user's tool call; some clients require trust or use parent-agent handoff instead.
1818
- Persistent operation: a per-account daemon coordinates sessions and indexing. Existing indexes can stay synchronized during eligible active MCP sessions; initial auto-indexing is separately opt-in. Optional team graph artifacts share a baseline while each user keeps a local query database.
1919
- Token-efficient retrieval: targeted graph queries, focused source snippets, and compact, paged results can reduce token use and repeated file reads during code exploration.
2020
- Distribution: native C backend, MIT license, standard native releases for macOS, Linux, and Windows include CBM Lens; Linux portable archives provide static builds. Nix and development source builds can omit the UI. Package-manager options and release verification are documented in the README.
2121

2222
## Client coverage
2323

24-
- Supported agents: 45 automatic/conditional client surfaces (39 automatically detected + 6 conditional/explicit): Claude Code, Codex CLI, Gemini CLI, Zed, OpenCode, Antigravity, Aider, KiloCode, VS Code, Cursor, Windsurf, Augment / Auggie, OpenClaw, Kiro, Junie, Hermes, OpenHands, Cline, Warp, Qwen Code, GitHub Copilot CLI, Factory Droid, Crush, Goose, Mistral Vibe, Grok Build, Qoder CLI, Kimi Code CLI, GitLab Duo CLI, Rovo Dev CLI, Amp, Devin CLI / Local, Tabnine, Continue / cn, Visual Studio, TRAE, Roo Code, Amazon Q Developer IDE, CodeBuddy Code CLI, IBM Bob IDE, IBM Bob Shell, Pochi, Pi, Oh My Pi (omp), and Sourcegraph Cody.
24+
- Supported agents: 46 automatic/conditional client surfaces (40 automatically detected + 6 conditional/explicit): Claude Code, Codex CLI, Gemini CLI, Zed, OpenCode, Antigravity, Aider, KiloCode, VS Code, Cursor, Windsurf, Augment / Auggie, OpenClaw, Kiro, Junie, Hermes, OpenHands, Cline, Warp, Qwen Code, GitHub Copilot CLI, Factory Droid, Crush, Goose, Mistral Vibe, Grok Build, Qoder CLI, Kimi Code CLI, GitLab Duo CLI, Rovo Dev CLI, Amp, Devin CLI / Local, Tabnine, Continue / cn, Visual Studio, TRAE, Roo Code, Amazon Q Developer IDE, CodeBuddy Code CLI, IBM Bob IDE, IBM Bob Shell, Pochi, Pi, Oh My Pi (omp), agentty, and Sourcegraph Cody.
2525

2626
## Measurement and limits
2727

‎pkg/npm/README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
**Local code intelligence for developers and AI agents.** CBM connects source code, documentation and infrastructure in a persistent knowledge graph. Explore through MCP, the CLI or CBM Lens to find code, trace dependencies and deployments, and understand what a change affects.
99

10-
This npm wrapper downloads, verifies and caches the native executable, its authenticated integration asset and the content-addressed Lens frontend pack. Node.js manages installation and launch; the graph is processed locally without a hosted service or API key. The installer offers 45 client integration targets, with capabilities that vary by client.
10+
This npm wrapper downloads, verifies and caches the native executable, its authenticated integration asset and the content-addressed Lens frontend pack. Node.js manages installation and launch; the graph is processed locally without a hosted service or API key. The installer offers 46 client integration targets, with capabilities that vary by client.
1111

1212
## Installation
1313

@@ -35,8 +35,8 @@ Restart your agent and ask it to **"Index this project"**. Use `codebase-memory-
3535
- **Focused context** — retrieve symbols, relationships and bounded source excerpts instead of repeatedly reading whole files. Savings depend on the task and workflow.
3636
- **CBM Lens** — explore source, architecture, call paths, decisions and index coverage in a local browser workspace.
3737
- **Smart CI** — experimental change-aware test selection for supported C/C++ test runners, using graph relationships and admitted per-test coverage. Missing evidence broadens execution. See the [Smart CI guide](https://github.com/DeusData/codebase-memory-mcp/blob/main/docs/SMART_CI.md).
38-
- **45 supported automatic/conditional client surfaces** — `install` configures the appropriate MCP, durable-context, and documented hook surfaces without widening client permissions.
39-
- **Detected automatically (39)** — Claude Code, Codex CLI, Gemini CLI, Zed, OpenCode, Antigravity, Aider, KiloCode, VS Code, Cursor, Windsurf, Augment / Auggie, OpenClaw, Kiro, Junie, Hermes, OpenHands, Cline, Warp, Qwen Code, GitHub Copilot CLI, Factory Droid, Crush, Goose, Mistral Vibe, Grok Build, Qoder CLI, Kimi Code CLI, GitLab Duo CLI, Rovo Dev CLI, Amp, Devin CLI / Local, Tabnine, Amazon Q Developer IDE, CodeBuddy Code CLI, IBM Bob Shell, Pochi, Pi, and Oh My Pi (omp).
38+
- **46 supported automatic/conditional client surfaces** — `install` configures the appropriate MCP, durable-context, and documented hook surfaces without widening client permissions.
39+
- **Detected automatically (40)** — Claude Code, Codex CLI, Gemini CLI, Zed, OpenCode, Antigravity, Aider, KiloCode, VS Code, Cursor, Windsurf, Augment / Auggie, OpenClaw, Kiro, Junie, Hermes, OpenHands, Cline, Warp, Qwen Code, GitHub Copilot CLI, Factory Droid, Crush, Goose, Mistral Vibe, Grok Build, Qoder CLI, Kimi Code CLI, GitLab Duo CLI, Rovo Dev CLI, Amp, Devin CLI / Local, Tabnine, Amazon Q Developer IDE, CodeBuddy Code CLI, IBM Bob Shell, Pochi, Pi, Oh My Pi (omp), and agentty.
4040
- **Conditional or explicit (6)** — Continue / cn, Visual Studio, TRAE, Roo Code, IBM Bob IDE, and Sourcegraph Cody. Bob IDE is touched only when `~/.bob/mcp.json` already exists.
4141
- **New documented adapters** — CodeBuddy uses `~/.codebuddy/.mcp.json` while preserving active older files; Bob Shell uses `~/.bob/mcp_settings.json`; Pochi uses the `mcp` section in `~/.pochi/config.jsonc`; Amazon Q Developer IDE defaults to `~/.aws/amazonq/default.json` while preserving either documented alternative.
4242
- **Lifecycle hooks stay conservative** — Kimi uses `UserPromptSubmit`; on macOS/Linux, GitLab Duo gets a fail-open user `SessionStart`, while Devin gets `UserPromptSubmit`, `PostCompaction`, and a deduplicated `SessionStart` when Claude does not already provide it. Qoder, GitLab Duo, Devin, and Factory hooks are withheld on Windows without a documented shell/executor contract. Cline's auto-activating file hooks are withheld because their context output is not reliably consumed, CodeBuddy beta hooks are not auto-installed, and Cursor context hooks remain withheld.

‎src/cli/agent_clients.c‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,9 @@ static const cbm_agent_client_profile_t agent_profiles[CBM_AGENT_CLIENT_COUNT] =
7676
{CBM_AGENT_CLIENT_OMP, "omp", "Oh My Pi (omp)", CBM_AGENT_STABLE,
7777
CBM_AGENT_CAP_MCP | CBM_AGENT_CAP_SKILL | CBM_AGENT_CAP_AGENT, "omp", agent_install_callback,
7878
agent_remove_callback},
79+
{CBM_AGENT_CLIENT_AGENTTY, "agentty", "agentty", CBM_AGENT_STABLE,
80+
CBM_AGENT_CAP_MCP | CBM_AGENT_CAP_SKILL, "agentty", agent_install_callback,
81+
agent_remove_callback},
7982
};
8083

8184
size_t cbm_agent_client_count(void) {
@@ -601,6 +604,14 @@ int cbm_agent_client_resolve_path(cbm_agent_client_id_t id,
601604
int written = snprintf(path_out, path_out_size, "%s", options->cody_config_path);
602605
return written >= 0 && (size_t)written < path_out_size ? 0 : -1;
603606
}
607+
case CBM_AGENT_CLIENT_AGENTTY:
608+
/* $AGENTTY_MCP_CONFIG names the one file agentty reads instead of
609+
* ~/.agentty/mcp.json, so install and uninstall must target it. */
610+
if (options->agentty_mcp_config && options->agentty_mcp_config[0]) {
611+
int written = snprintf(path_out, path_out_size, "%s", options->agentty_mcp_config);
612+
return written >= 0 && (size_t)written < path_out_size ? 0 : -1;
613+
}
614+
return agent_join_path(path_out, path_out_size, options->home_dir, ".agentty/mcp.json");
604615
default:
605616
return -1;
606617
}
@@ -663,6 +674,8 @@ static int agent_client_marker_path(cbm_agent_client_id_t id,
663674
return agent_join_path(path_out, path_out_size, options->home_dir, ".omp/agent");
664675
case CBM_AGENT_CLIENT_PI:
665676
return agent_join_path(path_out, path_out_size, options->home_dir, ".pi/agent");
677+
case CBM_AGENT_CLIENT_AGENTTY:
678+
return agent_join_path(path_out, path_out_size, options->home_dir, ".agentty");
666679
default:
667680
return 1;
668681
}
@@ -1466,6 +1479,7 @@ static bool agent_json_client(cbm_agent_client_id_t id) {
14661479
case CBM_AGENT_CLIENT_IBM_BOB_SHELL:
14671480
case CBM_AGENT_CLIENT_POCHI:
14681481
case CBM_AGENT_CLIENT_SOURCEGRAPH_CODY:
1482+
case CBM_AGENT_CLIENT_AGENTTY:
14691483
return true;
14701484
case CBM_AGENT_CLIENT_CONTINUE:
14711485
case CBM_AGENT_CLIENT_PI:

0 commit comments

Comments
 (0)