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. .gitignore is 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, *end typed 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 relay provides 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/christopherkahlerbase.svg)](https://yunodb.com/tools/christopherkahlerbase?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/christopherkahlerbase?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/christopherkahlerbase.svg" alt="Featured on YunoDB" height="20"></a>