@nickm-swe/marrow
v0.1.5
Published
A local, deterministic MCP server that parses multi-language codebases into an AST dependency graph.
Maintainers
Readme
@nickm-swe/marrow
Marrow is a local, deterministic Rust MCP server and CLI. It parses your codebase with tree-sitter, builds a cross-repository dependency graph in a local SQLite database, and serves deterministic structural context — callers, blast radius, condensed code capsules — to AI coding agents. No embeddings, no provider SDKs, no network calls.
This npm package is a thin installer: it downloads the matching GitHub release archive for your platform, verifies it against checksums.sha256, extracts the marrow binary securely, and runs it from the package dist/ directory.
Install
npm install -g @nickm-swe/marrowQuick start
Using Marrow is one word:
marrowJust like claude opens Claude Code, marrow opens the Marrow hub: it shows your installed version, workspace status, and index health, then walks you through everything — connecting coding agents, indexing, compiling context packets, querying symbols, and diagnostics. On a fresh workspace it tells you exactly where to start.
Prefer direct commands? Every hub action is also a subcommand:
marrow integrate # connect Claude Code, Cursor, Copilot & more
marrow index # index the current directory
marrow context "trace request flow" --repo my_repo --format markdown
marrow doctor # verify the index answers agent queriesCommands
Type marrow for the interactive hub, or run any command directly. marrow --help prints the full grouped reference.
| Command | Purpose |
|---------|---------|
| marrow | Open the interactive hub (version, workspace status, guided actions). |
| marrow mcp | Start the MCP stdio server (used by editor/agent integrations). |
| marrow init | Initialize workspace config (.marrow/, .marrowrc.json). |
| marrow index | Index the current workspace. |
| marrow watch | Keep the index fresh via the background daemon. |
| marrow context <task> | Compile a provider-neutral context packet (markdown/JSON). |
| marrow query <symbol> <repo_id> | Print a symbol's context capsule plus impact analysis. |
| marrow integrate | Write/print MCP setup for supported agent targets. |
| marrow doctor | Verify indexed repos answer agent queries. |
| marrow ui / marrow ui-app | Open the dashboard / manage the desktop app entry. |
| marrow daemon [install\|uninstall\|status] | Background daemon and autostart management. |
The npm postinstall step does not register the desktop app or daemon. To add desktop app entries explicitly, run:
marrow ui-app enableDaemon autostart remains separate and opt-in through marrow daemon install.
Learn more
- Full README, architecture, and measured benchmarks: github.com/NDMyers/marrow
- Context packet reference: docs/context-packets.md
- Environment variable / configuration reference: docs/configuration.md
- Changelog: CHANGELOG.md
- Issues: github.com/NDMyers/marrow/issues
License
MIT — see LICENSE.
