contextium
100% Open Source MIT

A way of working
that holds up.

Most AI sessions start from zero, then drift halfway through a long thread. Contextium is the methodology that fixes that. Give your AI an operating system.

terminal
$ curl -sSL contextium.ai/install | bash

You can see what AI should be.

A genuine multiplier across everything you build. But every session starts from zero. You re-explain your preferences, the AI makes a plausible guess, drifts halfway through a long thread, and tomorrow you start over. The gap between AI's promise and your reality never closes.

A pile of prompts

Snippets you paste, a memory feature that's a flat list of facts, rules nobody enforces. No structure that survives a long thread. Day 1,000 looks like day 1.

A sticky note.

Contextium

A way of working: a thinking-and-doing loop with fresh context between them, rules backed by hooks that actually fire, and memory written down every session. Each session builds on the last.

An operating system.

The core

Three verbs. Fresh context
between thinking and doing.

The Loop is one command per verb. The boundary between them is the point: a session that wrote the plan and grew attached to its choices is the wrong one to also judge the work.

Think

/project

Plan the work and write a short SPEC of what success looks like. No code yet, just a clear target.

Do

/implement

Execute the SPEC with self-validation, starting from a clean context. A new session catches what the invested one defends.

Wrap

/close

Journal what happened and why, one file for the day, then commit. Tomorrow's session reads it and picks up where you left off.

Plus /probe for adversarial self-review, /explain for deep investigation, and a few more. Seven skills total.

commit-gate hook fires at commit
destructive-git guard hook fires at commit
memory-write guard hook fires at edit
your own rules wire as you grow
Not suggestions

Rules backed by
real mechanisms.

A rule that lives only in a document gets forgotten in the exact moment it was written to cover. Contextium's rules that matter are wired to hooks that actually fire: a commit gate, a destructive-git guard, a memory-write guard.

Advisory prose is allowed, but it's honest about being advisory. When a correction recurs, you write it down once and give it a mechanism. The layer becomes yours.

Accountability

Memory in two layers.
What and why.

The git log records what changed. The journal records why, one file per day, written by /close at the end of a session.

Reconstructing an old decision needs both, so the system keeps both. Six months from now you can see what you chose, what you rejected, and the reasoning, instead of re-exploring the same dead ends.

$ git log --oneline journal/
a3f2c1d Chose Postgres over DynamoDB — relational fit
8b1e4a7 Rejected the daemon — a 30-line script did it
c7d9f2e Split the parser — boundary cases were leaking
1e5a3b8 Reverted the cache — staleness beat the speed
f4c8d1a Picked MIT over Apache — simpler for a template
# Every "why" preserved, one file per day.
Claude
Today
Codex
Tomorrow
Gemini
Next year
Your Contextium
Same context. Zero migration.
No lock-in

Your context. Your data. Forever.

It's plain markdown in a git repo that you own. No platform holds it hostage. If a tool raises prices or pivots, your accumulated context doesn't vanish with it.

Built on Claude Code, but the methodology travels. One source generates the instruction file each agent reads, so Codex, Cursor, Gemini, Copilot, Windsurf, Cline, and Aider all run the same Loop without drift.

One command. You're in.

The installer lays down the .claude/ layer and a starter CLAUDE.md, asks your name and how autonomous you want the AI, and leaves your data alone on re-runs.

terminal
$ curl -sSL contextium.ai/install | bash
1

The installer asks

Your name and how autonomous the AI should be. It writes a starter CLAUDE.md and lays down the .claude/ methodology layer.

2

Open and run /project

Open the repo in Claude Code (or your agent of choice) and start the Loop. The rules, skills, and hooks are already in place.

3

It starts compounding

Each session journals its reasoning and commits. Re-run bash install.sh anytime to refresh the layer without touching your data.

What's inside

A .claude/ layer plus a starter CLAUDE.md and empty data directories that grow as you work.

.claude/skills/

7 Skills

The Loop verbs (project, implement, close) plus probe, explain, debate, and propose-rule. One keystroke each.

.claude/rules/

8 Principles

Always-loaded and kept short on purpose: voice, depth, boundaries, simplicity, no-deferral, mechanisms, journal format, and how to write your own.

.claude/hooks/

Wired Hooks

Mechanisms that fire: a commit gate, a destructive-git guard, a memory-write guard, a session checklist. Not documentation. Infrastructure.

.claude/agents/

4 Review Agents

Fresh-context sub-reviewers the skills dispatch when they need a second set of eyes: code review, probe, research, spirit-check.

knowledge/ · journal/

Your Data Layer

Empty skeletons to start: people, goals, business context, daily logs, multi-session projects. They grow richer every session.

templates/integrations/

15 Connector Starters

Docs-only templates for wrapping external services (GitHub, Google, Notion, Todoist, and more). Configure only what you need.

Grow into it

Lean on purpose.

This ships as a methodology, not a pile of features. The heavy machinery, orchestration platforms, large reconcilers, multi-model SPEC review, per-session worktrees, is documented as advanced patterns you can grow into.

You start with the way of working and add weight where your own work demands it. Nothing you don't use is wired in.

100% Open Source

Free forever. No catch.

Contextium is MIT licensed. No premium tier. No hosted service. No data collection. Just a git repo of markdown files that you own completely.

MIT License Plain Markdown Git-Versioned No Telemetry

Stop starting from zero.

Run one command, then try /project. Then every session compounds.

$ curl -sSL contextium.ai/install | bash

MIT · Plain markdown · No lock-in