# Jumbo — Memory for AI Coding Agents

> Jumbo is a free, open-source CLI tool that gives coding agents persistent, structured memory. It captures project context (goals, architecture, components, dependencies, decisions, guidelines, invariants) as they arise during agent sessions, and serves optimized context packets back to agents automatically.

## What Jumbo Does

- **Context Engineering, Automated**: Jumbo replaces manual markdown-based context engineering with an immutable event stream that captures your project's living memory.
- **Agent Memory**: Your coding agent remembers project goals, architecture decisions, component structures, dependencies, coding guidelines, and invariants across sessions.
- **Portable**: Works across all frontier coding agents and harnesses — Claude Code, GitHub Copilot, Gemini CLI, Cursor, VS Code, Warp, AMP, and more. Switch between them without losing context.
- **Privacy-First**: All data stays local on your machine. Nothing is transmitted externally.
- **Zero Overhead**: No network calls, no lag. Hooks into agent sessions automatically.

## Homepage Sections

- **Problem**: Agent amnesia, low-quality unguided output, and context lock-in are the core pain points Jumbo addresses.
- **Capabilities**: Jumbo gives agents memory, quality guardrails, orchestration, interoperability, and portable context.
- **Workflow**: Developers define goals, agents execute with curated context, and corrections are captured as durable project memory.
- **Install**: Install with `npm i -g jumbo-cli`, run `jumbo`, then start a coding agent such as Claude Code.
- **Jumbo Herd**: Shared project memory keeps every engineer and coding agent aligned around the same goals, decisions, and constraints.

## Key Concepts


## Install

```
npm i -g jumbo-cli
```

## Links

- Homepage: https://jumbocontext.com
- Jumbo Herd early access: https://jumbocontext.com/herd
- GitHub: https://github.com/jumbocontext/cli
- npm: https://www.npmjs.com/package/jumbo-cli
- Discord: https://discord.gg/V5JDfu5avk

## FAQ

- **What is Jumbo?** — Jumbo is a CLI tool that gives your coding agents persistent memory and structured project context, turning them from makers of workable prototypes into builders of production-quality software.
- **Is Jumbo for context engineering?** — Exactly! Jumbo is essentially context engineering with a fraction of the effort required to maintain markdown files and with better results. It works by collecting insights about your project as they arise in your agent workflow and serving context automatically to your coding agent.
- **How does Jumbo integrate with my AI agent?** — Through hooks, with fallback to AGENTS.md. Your agent calls jumbo session start at the beginning of a session, and Jumbo injects relevant project context. A richer context packet is delivered when the agent starts work on a goal. New insights are captured in the natural flow of your agent conversations.
- **What if I change agents or models?** — Change agents and models at will. Jumbo is harness- and model-agnostic. It works with any coding agent that supports AGENTS.md and truly excels with harnesses that support open agent skills. Jumbo just picks up where you left off.
- **Can I control what data Jumbo captures?** — Absolutely. You control how you want your agent to interact with Jumbo. Stay in-the-loop by approving each command, or run with pre-approved Jumbo commands for an automated experience.
- **Is Jumbo going to hijack my agent?** — Not at all. Jumbo prescribes an opinionated workflow that you can always bypass. It works alongside your agent to enhance its capabilities.
- **How does Jumbo ensure privacy?** — All data stays local. Nothing leaves your machine. Jumbo stores everything in .jumbo/ in your project directory.
- **Why not just use markdown files?** — Jumbo goes beyond static markdown files. It's an immutable event stream — capturing your entire project history, always current and auditable. You stay in your flow, never repeat yourself — only add new information when you need to. Markdown is a snapshot in time, Jumbo is your project's living memory.
- **How do I install Jumbo?** — Three commands: npm i -g jumbo-cli, then jumbo in your project, then start your coding agent. Jumbo hooks in automatically.
- **Does Jumbo work for teams?** — Jumbo is currently optimized for single developer use. A cloud version for teams — Jumbo Herd — is under development. Sign up to get notified when it launches.