mimir

Mimir is a local-first source of truth for agent-driven work. It keeps projects, tasks, dependencies, decisions, and work products in one queryable system so an agent can act on current state and an operator can see what needs attention.

Work state lives as inspectable Markdown in a Norn-managed, git-backed vault. Mimir derives queues, status rollups, blockers, and stale work when queried; there is no second cache of project status to keep in sync.

Why Mimir

• One work model. The CLI, MCP server, HTTP API, and operator console use the same domain logic.
• Agent-ready context. Repository binding and mimir overview give an agent the current direction, active work, ready queue, dependencies, and recent sessions.
• Operator control. The console spans projects, tasks, Artifacts, Seeds, and record health. It supports daily authoring and lifecycle actions.
• Local ownership. Markdown is the source of truth. Norn owns validated, atomic access; Git can snapshot and synchronize the vault.
• Derived state. Rank, dependencies, lifecycle, and holds determine what is ready, awaiting, blocked, stale, or complete.

What it handles

Need	Mimir capability
Plan and run work	Project → initiative → phase → task hierarchy, ranked queues, dependencies, lifecycle, and holds
Preserve outcomes	Frozen, tagged Artifacts linked to the work that produced them
Keep temporary context	Resumable Scratchpads with a Journal and Agenda that freeze into Artifacts
Groom new work	Seeds for ideas, bugs, features, and cross-project requests
Resume agent sessions	Direction, execution handles, annotations, and session-summary Artifacts
Operate the store	Record diagnostics, conservative repair, snapshots, service management, and self-update

Five-minute start

Install the standalone binary:

curl -fsSL https://raw.githubusercontent.com/dbtlr/mimir/main/install.sh | sh
mimir setup

Mimir requires norn on PATH. Setup creates or adopts a vault and can install the local service. Then create a project and bind a repository to it:

mimir create project "Aurora" --key AUR --yes
cd path/to/aurora
mimir bind AUR
mimir skill install --global --agent codex

From the bound repository, an agent can orient and begin the highest-ranked ready task without repeating the project key:

mimir overview
mimir next
initiative_id=$(mimir create initiative "Release 1.0" --parent AUR -f ids)
task_id=$(mimir create task "Verify sign-in recovery" --parent "$initiative_id" --size s -f ids)
mimir start "$task_id"

Run mimir serve and open the URL printed at startup to use the operator console. The production default is http://127.0.0.1:64647/; Mimir remains loopback-only, so remote access belongs behind a trusted reverse proxy.

Learn Mimir

• Start with an agent-driven repository
• Plan and run work
• Capture temporary work with Scratchpads
• Preserve work products as Artifacts
• Groom new work with Seeds
• Use the operator console
• Work with agents

The user guide collects these workflows. Installed-service operations live in docs/guides. The maintained schema, output contract, and ADRs cover engineering details.

Status

Mimir is pre-release (0.x) and built for a single operator. The CLI, MCP, HTTP API, and console cover read and write workflows. The console is an installable PWA with cached offline reads; writes require a live server and are not queued offline. Authentication and multi-operator collaboration are outside the current binary.

Develop

Mimir uses Bun 1.3.14:

bun install
bun run verify

Generate the deterministic demo workspace used for documentation and visual testing with bun run fixtures:vault .dev/docs-fixture. See CONTRIBUTING.md for the project structure and review process.

License

MIT