fullerenes
v0.1.4
Published
Local-first CLI and MCP server for codebase knowledge graphs
Downloads
653
Maintainers
Readme
fullerenes
Fullerenes builds a local knowledge graph of your codebase and exposes it through a CLI, generated agent files, and an MCP server. It is designed to help coding agents find the right code fast while using far fewer tokens than broad raw-file prompting.
What's New
This release includes:
- fully local-first generated summaries with no external LLM dependency
- better natural-language retrieval and query expansion
- smaller, tighter graph-grounded query results
- improved generated
AGENTS.md/CLAUDE.mdguidance - cleaned-up CLI and MCP version reporting
Quick Demo
Install
npm install -g fullerenesOr run it without installing:
npx fullerenes initTypical Workflow
Index a repository:
fullerenes initAsk questions against the local graph:
fullerenes query "how does auth work"
fullerenes statsStart the MCP server:
fullerenes mcp .Keep the graph fresh while coding:
fullerenes watch .MCP Highlights
get_function({ name: "resetCache", includeBody: true })predict_impact({ functionName: "resetCache" })query_codebase({ question: "how does indexing work", maxTokens: 1600 })
Commands
fullerenes init
fullerenes index
fullerenes query "how does auth work"
fullerenes stats
fullerenes mcp .
fullerenes watch .What It Generates
CLAUDE.mdAGENTS.md.cursor/rules/fullerenes.mdc
What It Exposes
- local graph database at
.fullerenes/graph.db - MCP server for agent integrations
- token-budgeted local graph queries
- caller-aware impact inspection
Learn More
- GitHub repo: https://github.com/codebreaker77/Fullerenes
- npm package: https://www.npmjs.com/package/fullerenes
License
MIT
