base
AI builder operating system. Turn Claude Code from a per-session tool into a workspace that remembers, maintains itself, and never goes stale. BASE = Builder's
What is base?
AI builder operating system. Turn Claude Code from a per-session tool into a workspace that remembers, maintains itself, and never goes stale. BASE = Builder's Automated State Engine.
Overview of base
What it is
base is an AI builder operating system that turns Claude Code from a per-session tool into a workspace that remembers, maintains itself, and never goes stale. It is implemented as a single Rust binary, base, which maps a workspace into a knowledge graph and wires it into Claude Code's hook pipeline. The graph stores code structure, projects, decisions, rules, and relationships, and places the relevant slice of context in front of the model at the moment it is needed. No prompt to paste or document to maintain is required.
Key features
- Knowledge graph: extracts functions, structs, classes, imports, and call relationships using tree-sitter across 35+ languages, queryable via SPARQL.
- Automatic code mapping: the first session in an app builds the map in the background; subsequent reads and edits refresh it automatically.
.gitignoreis honored. - Four hook injection points: session start, at the prompt, before a tool runs, and after it returns. Each injection is a targeted query against the current moment.
- Star commands:
*handoff,*fork,*base,*endtyped into the chat for session persistence and task hand-offs. - Auto-update: checks for new releases at session start, downloads in a background process, and swaps the binary atomically.
- Multi-session coordination:
base relayprovides titled sessions, instant pings, and briefed task hand-offs across live sessions. - Plain-text NQuads storage: all graph data lives in files that diff in git.
Use cases
- Navigating codebases: asking where a function is used returns a graph query result instead of a grep.
- Maintaining context across sessions: decisions, tasks, and learnings are swept into the graph and resurface automatically.
- Enforcing project rules: domain rules fire when the context matches, without manual prompting.
- Managing multiple concurrent sessions: relay enables hand-offs and coordination between agents.
Getting started
Install Claude Code first. Then run the one-liner for your platform: sh curl -fsSL https://raw.githubusercontent.com/ChristopherKahler/base/main/install.sh | sh For Windows: powershell irm https://raw.githubusercontent.com/ChristopherKahler/base/main/install.ps1 | iex After installation, point it at a workspace: sh cd ~/my-workspace base scaffold To build from source (requires Rust toolchain): bash cargo build --release ./target/release/base install
License and pricing
The project is open source. The license is listed as NOASSERTION in the metadata.
Based on the project's public README and repository metadata.