Introduction
codel00p is an open-source coding agent that turns finished work into reviewed, durable project memory. It runs locally from a single CLI.
Most agents start every session from zero. They relearn the same repository structure, conventions, and decisions on every run. codel00p treats that knowledge as the product: a run does real repository work, proposes memory candidates from what it learned, and you review them. Only approved memory is fed back into future runs.
Everything is stored in one local SQLite file you own. There is no service to sign up for and nothing leaves your machine unless you point a provider at a remote endpoint.
How it is built
codel00p is a small set of Rust crates with one clear responsibility each. The CLI is the first interface over them.
codel00p-harness— the agent turn loop, workspace-safe tools, permissions, and event stream.codel00p-memory— the candidate, approved, and archived lifecycle for project knowledge.codel00p-providers— one contract over Anthropic, OpenAI, Bedrock, Gemini, and OpenAI-compatible gateways.codel00p-mcp— Model Context Protocol client and server, so external tools and other agents can connect.codel00p-storage,codel00p-session, andcodel00p-protocol— persistence, durable sessions, and the shared data contracts between crates.
How to read these docs
Start with Getting started to install the CLI and run your first agent turn. Then read Architecture to understand how the pieces fit together. The Guides cover day-to-day tasks, and Reference lists every command.