Jumbo Context

Tired of repeating yourself to Claude, Codex, Gemini, Copilot and their cohorts?

Agents shouldn't have to be re-taught your project every session. Jumbo gives them the context they're missing, so you don't have to.

• Memory (Capture important details about your project once)
• Continuity across sessions
• Automatic goal specification
• Extended context windows
• Concurrent agents
• Harness and model agnostic

Can we address the elephant in the room?

(a.k.a. What problems does this solve?)

Working with coding agents is amazing. But let's be honest, it' not without frustration. Here are the common issues:

• Agent Amnesia: It's a thing. Every session that came before is forgotten. You spend time and energy getting the agent caught up before you even start thinking about your goals.

• Slop: AI without guardrails can produce code that kind of works, but it’s rarely production-ready. Worse, it can leave behind a mess that takes hours to untangle. That’s not a productivity boost — it’s a hassle.

• Vendor lock-in: If an agent harness holds your memory, switching tools means losing that context. With new models and tools shipping every week, switching is inevitable. Your context should move with you.

How does Jumbo help?

Jumbo was created to address these frustrations and unlock the full joy of coding with agents.

• Memory: Details about your project are saved, so your agents always have the correct context. Agent Amnesia is, well...forgotten.

• Quality: Your coding agents write shippable code on the first shot. You save time and tokens.

• Interoperability: Jumbo is harness- and model-agnostic.

• Portability: Switch to new models when they're released. Your context stays with you.

• Orchestration: Run different agents in parallel. Optimize for capability and cost. Jumbo keeps everything in sync.

Those solve the core problems. These make Jumbo pleasant to use:

• Extended context windows: Run agents longer without context rot.*

• Automatic: Hooks into your agent session and orchestrates the flow. It just works.

• Full control: Jumbo's memories are yours. Stay in control and manage your data directly from the terminal.

• Private: All data stays local. Nothing leaves your machine.

• Fast: No network calls. No lag. Everything runs locally.

* Only works for harnesses that support hooks.

Quick Start

1. Install Jumbo globally

> npm i -g jumbo-cli

2. Browse your project folder and run Jumbo

> jumbo

Jumbo will guide you in getting started.

3. Run your agent as normal (claude, codex, gemini, vibe)

> claude
[Nudge your agent once its running]
> Follow instructions

Jumbo will automatically orient the agent about your project and available goals.

[!NOTE] Goals are the heart of Jumbo. Every memory, guideline, and constraint attaches to a goal — so define your work there first. (see jumbo goal add --help)

Your agent can help define goals too. It knows how to use Jumbo.

[!TIP] Hit the ground running with the Jumbo Memories repo — a curated library of best practice guidelines and invariants ready to drop into any project.

See the Getting started guide for the full workflow.

Compatibility

Jumbo seamlessly integrates with all frontier harnesses and models. Use them interchangeably or in parallel.

It also works with any agent that supports AGENTS.md and truly excels with harnesses that support open agent skills.

Use Jumbo in a harness that supports hooks and you'll never think about context windows again.

How does it work?

It's simple. You just define your goals — describe your objective, criteria, and scope. Then run your agents and Jumbo guides them through the workflow:

1. Refine: Your agent collaborates with Jumbo to couple all relevant memories to your goal and build a context packet ready for the agent to implement.
2. Implement: Jumbo serves a curated context packet to your agent when it starts work on your goal.
3. Review: Your agent reviews the goal against criteria and project specification. Non-passing goals are rejected and queued for reimplementation.
4. Codify: Agents update documentation, change logs, and register any missing details that need to be preserved for future goals.

You don't have to remember all these steps. Jumbo hooks into your agent sessions and guides the entire flow.

Every time you start Claude Code (or similar) Jumbo will orient the agent about the state of your project. The agent will prompt you with an overview of planned work and ask what you want to work on. Just point at a goal and watch the magic happen.

What's in the trunk?

Jumbo remembers:

Your domain:

• Project: What you are building and who it's for.
• Audiences: Who uses your project and their priorities.
• Audience Pains: The problems your audiences face that you aim to solve.
• Value Propositions: How your product addresses each audience pain.

Your solution:

• Architecture: Your solution design, structure, and patterns applied.
• Components: The parts comprising your solution and their roles.
• Dependencies: Third-party packages and external services your project relies on.
• Decisions: History of why you chose what you chose.
• Guidelines: Preferences, best practices, and the standards you adhere to.
• Invariants: Rules you simply won't compromise on.
• Relations: The graph that ties it all together.

Your operations:

• Goals: The specifics - objective, criteria, scope, boundaries, and contextual relations.
• Sessions: Manage work continuity with pause, resume, compact, and multi-agent support.

Architecture

Jumbo follows Clean Screaming Architecture — four layers, strict dependency rules, and file names that tell you exactly what they do.

• Domain: Aggregates, events, and policies. Zero dependencies on anything outside.
• Application: Command handlers, controllers, and gateway abstractions. Orchestrates the workflows.
• Infrastructure: Event store, SQLite projections, and gateway implementations. The concrete stuff.
• Presentation: CLI commands and output builders. Parses input, formats output, stays in its lane.

Dependencies always point inward. Swap out the infrastructure and nothing else notices.

Core patterns:

• Event Sourcing: Every state change is a domain event, appended to an immutable JSONL log. Full history, full replay.
• CQRS: Writes produce events through command handlers. Reads come from SQLite views. Each side is optimized independently.
• DDD: One aggregate per bounded context. Domain events live next to their entity. Business rules stay pure.
• Gateway Pattern: Controllers talk to abstractions. Infrastructure provides the implementations. Wired up at startup via Inversify.

Data lives in two stores:

• Event store: Append-only JSONL files. Human-readable. The source of truth.
• SQLite: Fast read views projected from the event stream. Rebuildable anytime with jumbo db rebuild.

When your agent starts a goal, Jumbo assembles a context packet on the fly — pulling in the components, decisions, guidelines, invariants, and architecture linked to that goal through relations. No stale caches. Always current.

Built with

• Core Libraries:
  • better-sqlite3 : Read-model projections
  • commander : CLI framework
  • inversify + reflect-metadata : Dependency injection
  • yaml : Context serialization
• Terminal UI:
  • ink + react : Interactive terminal UI
  • inquirer : CLI prompts
  • chalk : Terminal styling
  • boxen : Terminal boxes
• Utilities:
  • date-fns : Date formatting
  • fast-glob : File pattern matching
  • fs-extra : File system utilities
  • jsonc-parser : JSON with comments parsing
  • ulid : Time-sortable unique IDs
  • uuid : Unique identifiers

Spread some ❤️ and sponsor the projects or buy them a cup of coffee. I have.

Documentation