Plan, execute, track, and resume - without losing state.

Your AI agent forgets everything. Your projects remember.

MissionCache keeps a living memory for every project - the plan, the decisions, the gotchas, what is left. It updates as you work, gets a snapshot before every compaction, and reloads with one command - the next session picks up exactly where this one stopped.

Not another memory plugin: task lists, time tracking, a local dashboard, and autonomous runs.

bash
$uvx missioncache-install
  • one command - a wizard asks what to install and which AI tools to register
  • everything lives under ~/.missioncache
  • about 3 minutes to first value

No uvx on your machine? It comes with uv - run pip install uv once, or see Install for other options.

Open source and MIT licensed. Everything runs on your machine, and nothing is sent anywhere - not even to us.

Your project. Every tool.

Claude Code Codex OpenCode VSCode Copilot

Start in one tool, pick it up in another - the whole project follows, with one MissionCache underneath connecting them all. Full workbench on Claude Code; project state + all 36 MCP tools everywhere.

MIT licensed Python 3.11+ MCP-compatible Local-first Modular install
localhost:8787/#attention
The MissionCache Attention view: work you owe, people grouped by how long they have owed you something, and every project with something outstanding
localhost:8787/#projects
MissionCache dashboard showing active and completed projects with progress bars and per-project time tracking
opens on what needs you · nothing lost in re-entry

The problem

Your AI coding sessions have amnesia.

The context window compacts. The session ends. Tomorrow your agent greets you like a stranger, and you rebuild the whole mental model - the plan, the decisions, what is left - from scratch. Every time.

A CLAUDE.md file holds static rules. This is living project state - the plan, the decisions, the gotchas, and what is left - that updates as you work and reloads on command.

MissionCache gives each project a durable home. Watch the loop on the right: state saved before compaction, restored the next morning.

claude · session demoreplay
loading replay…

Why MissionCache

Three things, in one tool.

Taskmaster manages tasks. claude-mem remembers. GSD executes. No single tool does all three - MissionCache is built as the integration. And because a project is just files any MCP tool reads and writes, it is not chained to one agent:

claude · auth-refactor
$ /missioncache:save ✓ context.md decisions · gotchas · next steps ✓ 5/12 tasks · written to ~/.missioncache
codex · same project, another tool
$ /missioncache:load auth-refactor ✓ plan restored · 5/12 tasks done ✓ decisions intact · gotchas loaded → next step: wire refresh-token rotation

Project state and all 36 MCP tools work in every tool. The dashboard, statusline, and autonomous runs are Claude Code today.

Your projects keep their memory

Not a static rules file. Every project is three human-editable files - plan, context, tasks - under ~/.missioncache/active/ that update as you work and survive session end and context compaction. /missioncache:load reloads the full state, so you pick up exactly where you left off.

persists across compaction

Full visibility into your time

MissionCache tracks heartbeats as you work and rolls them into per-project, per-repo, per-day and per-week views on a local dashboard. It even merges Claude Code's own session logs, so you always know which projects are eating your cycles.

local dashboard at :8787

Autonomous execution you can watch live

MissionCache Auto runs a project's tasks in parallel with dependency-aware DAG scheduling, logs every attempt, and streams the whole run to the dashboard. Watch it live or walk away and read the iteration log after.

parallel DAG scheduling

Why not the others

We will tell you when to use something else.

Every tool in this space does one thing. Here is the whole picture, checks and misses included.

Capability MissionCache Taskmaster AI claude-mem GSD Agent Teams
Project state that survives compaction~~~~task list only
Shared memory across parallel projects~tags isolate lanes~global memory
Task checklists + dependency DAG~~flat list
Per-project time tracking~cost only
Local analytics dashboard~
Autonomous execution
Whole project moves between toolsplan + tasks + progress~tasks only, 13 IDEs~memory only, 7+ agents

Full tables, with where each tool beats us, in the README. Claude Code gets the full workbench; Codex, OpenCode, and Copilot get the project state and all 36 MCP tools.

MissionCache is the only tool with per-project time tracking, a local analytics dashboard, and autonomous execution in the same place. And the only one where the whole project moves with you between tools. That is the whole point.

Taskmaster AIif you want PRD-to-task decomposition across 13 IDEs.
claude-mem / MemPalaceif you want cross-project memory that outlives any single project.
GSD / GSD-2if you want aggressive context-rot elimination with a fresh context per task.
MissionCacheif you want all of that integrated into one workbench for the project you are building now.

The lifecycle

From "new project" to "done" - and resumable at every step.

Five steps. Your state is safe between every one of them.

01 / NEW
/missioncache:new

Claude walks a clarifying conversation, proposes a plan, and drops the plan / context / tasks files once you approve.

02 / WORK
edit · test · decide

Your project files update as you work, and time is tracked in the background. The PreCompact hook auto-saves your state before the window compacts.

03 / LOAD
/missioncache:load

Reloads the plan, your decisions, the gotchas you flagged, progress, and where you left off. No reconstruction.

04 / AUTO
missioncache-auto

Optional. Hand the decomposed tasks to parallel workers and watch the DAG run on the dashboard.

05 / DONE
/missioncache:done

Archives the project and records final time and progress stats. That is the full loop.


Rich statusline

Your whole session, one glance up.

A live mission readout above your prompt: usage limits, Claude health, version, context, project progress - linked into the dashboard, and fully yours to shape. It even warns you before the context window forces a compaction, so you save state on your terms, not the window's.

missioncache-statusline

// the actual layout, rendered as text - yours draws above the prompt

Limits, with reset times

Claude session and weekly usage as percentages, each with its reset time. Opus tracked separately, Codex gets its own line when installed, and open incidents from status.claude.com surface right in the line.

Compact before it hurts

Context usage with tiered warnings: "Compact recommended" at 65%, "Compact now!" at 80% - so you save state on your terms, not the window's.

Make it yours

Project progress as [5/12], git branch, model, tokens, a version watch with an upgrade arrow. Toggle every field from the dashboard Settings, and add your own cells.

/whats-new

The installer also sets up /whats-new: it reads what changed in Claude Code since you last checked and proposes tailored upgrades to your own setup, with before/after diffs.


The Attention view

What needs you today, and who owes you what.

The dashboard opens here. Work you owe, what you are waiting on from other people, and every project with something outstanding. Nothing on this page is a separate list you have to maintain - it is your project files and your action items, read together.

Work you owe, from both places it hides

Action items assigned to you, plus rows in any project's Waiting on table whose Who column names you. The second kind is easy to lose: it sits in a file under someone else's heading. Marking one done writes straight back to the project file.

Chase by how long it has been quiet

People are grouped by the age of what they owe you: asked this week, one to two weeks, two to four, over a month. Someone who owes you two things of different ages shows up in both groups, so a fresh ask is never hidden behind an old one.

Everything with something outstanding

A project earns a row by having something outstanding: an open item on you, an ask out with someone, or a due date. Each carries what is next, checklist progress, what is on you, and how long since you touched it. Filter by category, or search what you last did.


Features

Built for people who live in the terminal.

Local analytics dashboard

Every hour, accounted for.

A FastAPI and vanilla-JS single-page app at localhost:8787. Active and completed projects, per-repo breakdowns, hourly heatmaps, a weekly activity view, and untracked Claude sessions shown alongside the tracked ones.

  • Dual database under the hood: SQLite for writes, DuckDB for analytics reads
  • Merges MissionCache heartbeats with Claude Code's own JSONL session logs
  • Runs as a background service - launchd on macOS, systemd on Linux
localhost:8787/#activity
Dashboard activity view: today's sessions, an hourly chart, a weekly heatmap, and a per-repository time breakdown
MissionCache Auto

Autonomous, and never a black box.

A standalone CLI that runs a project's tasks to completion in parallel. DAG scheduling respects dependencies so dependent work waits for its prerequisites. Default eight workers, or go sequential.

  • Every iteration logged with a timestamp, the task, the agent, and the outcome
  • On a git repo, each worker gets its own worktree and branch by default
  • Live execution streamed to the dashboard as it happens
missioncache-auto auth-refactor
MissionCache Auto view showing the task dependency DAG and a streaming live iteration log
Project forks · shared memory

Related projects, one shared memory.

Building several things on the same base? A data pipeline plus a test layer for each product it feeds. A backend plus its clients. They share the setup, the access details, the gotchas you already hit - but each needs its own task list.

/missioncache:fork creates a real second project that reads the parent's context file as its shared memory. Write the shared facts once, in the parent, and every fork knows them. When one session updates the shared memory, the others are told, so nobody keeps working from a stale picture.

  • Only the memory is shared. Tasks are never copied between a parent and its forks
  • The statusline adds a "Fork of <parent>" cell, with a dot when the shared memory is newer than what this session last read
  • Finish the parent whenever you want. Its memory stays readable, and its forks keep running
claude · two lanes, one memory
$ /missioncache:fork data-pipeline ios-tests ✓ ios-tests created · Fork of: data-pipeline ✓ shared context · data-pipeline ✓ own plan · own tasks · own progress $ /missioncache:fork data-pipeline android-tests ✓ android-tests created · Fork of: data-pipeline … the android session adds a gotcha to the shared layer … $ /missioncache:load ios-tests ● shared context updated by a sibling session → re-read data-pipeline context before you continue

Install

One command. Two flavors.

Pick the full workbench, or just the plugin core. Either way it is about three minutes to first value, and the machine part is under 30 seconds - measured, not promised. One session to feel it: run /missioncache:new, and your plan survives the first compaction.

$uvx missioncache-install
$pipx run missioncache-install# or, if you prefer pipx

The interactive wizard asks which components to install (default is all): the plugin, the dashboard as a background service, the missioncache-auto CLI, the statusline, and the rule files. For a hands-off run, use --all --yes.

Requires Python 3.11+ and the Claude Code CLI. The uvx command is part of uv - if you don't have it yet, install it once:

$pip install uv# or: curl -LsSf https://astral.sh/uv/install.sh | sh

No Python either? Use the curl command above - it needs nothing pre-installed. And pipx works in place of uvx if you already have it.

/plugin marketplace add missioncache/missioncache
/plugin install missioncache@missioncache

Run these inside Claude Code, then restart the session. You get the plan / context / tasks files, /missioncache:load resume, heartbeat time tracking, and all 36 MCP tools.

What you give up: no local dashboard, no missioncache-auto CLI, no rich statusline. Everything else stays.

FAQ

The questions developers actually ask.

How is this different from CLAUDE.md or built-in memory?

CLAUDE.md is a static rules file you maintain by hand. MissionCache keeps living project state - the plan, your decisions, the gotchas you flagged, and progress - that updates as you work and reloads with one command. It complements CLAUDE.md, it does not replace it.

When should I fork a project instead of starting a new one?

First, what a fork is here: a project fork, not a Claude conversation fork. It creates a real second project that shares the parent's memory (its context file) while keeping its own tasks. Fork when two efforts share one base and still need their own task lists. A data pipeline with a separate test layer per product is the normal shape. Architecture, access patterns, environment facts, the gotchas you already hit - they live once in the parent, and every fork reads them. Tasks are never copied. Start a fresh project instead when the two efforts have nothing real in common.

Where does my data live?

On your machine. Project files are plain markdown under ~/.missioncache/, and the dashboard runs locally at localhost:8787. Nothing is sent anywhere. The whole thing is local-first and self-hosted.

Do I have to install every component?

No. The MCP server plus the database is the minimum, and everything else is opt-in. The wizard lets you deselect the dashboard, auto, or statusline, and each package can be used on its own.

Which tools does it work with?

Claude Code gets the full experience. Codex, OpenCode, and VSCode Copilot Chat get the project state, the slash commands, and the 36-tool MCP suite today, with hooks, statusline, and auto tracked as a follow-up. The key part: the whole project - plan, tasks, progress, decisions - is one shared set of files, not recalled snippets, so you start in Claude Code and pick it up in Codex or OpenCode exactly where you left off.

Isn't this just cross-agent memory like claude-mem?

claude-mem and similar tools recall memories into whatever agent you are in - useful, but it is context injection. MissionCache moves the whole project: the plan you approved, the task checklist with its progress, the decisions and gotchas you logged - all as human-editable files any MCP agent reads and writes. Check off a task in Codex and Claude Code sees it. It is shared project state, not recalled memory. And if you want pure long-lived cross-project memory, claude-mem is genuinely good at that - we say so in the comparison.

Is it free?

Yes. MissionCache is open source under the MIT license. Read the code, change it, build on it.

Does it work on Windows?

Partially, today. The MCP server, project files, and missioncache-auto install and run fine. The lifecycle hooks - including the compaction snapshot and session tracking - do not run on Windows yet, and dashboard service registration prints manual steps instead of automating. A Windows port is on the roadmap.

What if I want to remove it?

Uninstall the packages and delete ~/.missioncache. Your project files are plain markdown, so anything you want to keep, you keep. Nothing is locked in.


Get started

Give your next project a memory.

One command, and you never rebuild your mental model from scratch again.

bash
$uvx missioncache-install