Your agent context is code now — it ships features, breaks builds, and gets out of sync the moment two engineers touch it. Contexo gives it the same discipline your repo has: diffs, history, branches, reviews, and a single source of truth.
CLAUDE.md in this repo, .cursor/rules in that one, a private Notion doc with the "real" system prompt, a Slack thread that explains why. Multiply by every teammate. Nothing is versioned. Nothing is shared. The agent always feels worse on someone else's machine.
Local rule files quietly diverge. The agent that ships Maya's PR is not the agent reviewing yours, and you can't tell.
When they leave, the institutional taste leaves with them. The next hire spends six weeks reinventing it from scratch.
Today, a prompt edit is a one-line copy-paste. No diff, no approver, no rollback. That's not engineering, that's vibes.
Contexo is a CLI and a service. If you've used git, you've used Contexo. The four commands below cover 95% of day-to-day work — the rest reads like a git man page on purpose.
Point Contexo at your project and it picks up CLAUDE.md, .cursor/rules, .windsurfrules, AGENT.md, and any MCP config you've got. One .ctx directory, every agent reads from it.
Pull the latest concepts, entities, and reasoning trails from your team's Contexo. Your agent walks in with the same context everyone else has — no re-deriving what's already known.
Push to a Contexo remote and open a context-request. Teammates review the diff, leave comments, approve. Merge to main and every agent in the org pulls it within seconds.
Mint an invite key for a teammate, a contractor, or your whole team. The key expires after a week, or an owner can revoke it at any time.
Every change to a system prompt, rule file, or MCP config gets a real review surface. Side-by-side diffs, threaded comments, eval CI, approvers. Nothing ships to production agents without a sign-off.
Generic file-sync misses the point. Contexo understands what a rule, a prompt, a tool scope, and an MCP server are — and treats them like first-class objects with their own diff semantics, eval hooks, and access scopes.
Token-level diffs miss the point — Contexo also surfaces behavioral diffs: what the agent said before, what it says now, on the same eval suite.
Define golden cases once. Every push runs them across the models you ship to. Regressions block merge, the way they should.
Every repo has owners and members, tracked in a real access table. Invite a teammate with a shareable key that expires after a week — and an owner can remove anyone's access in a single call.
A single .ctx folder feeds Claude Code, Cursor, Windsurf, Zed, and your own scripts. Switch tools without rewriting your prompts.
One binary, Postgres, S3-compatible object store. Air-gap clusters supported. Your context never has to leave your VPC.
Context-sharing is only half of it. Every session your agents run, Contexo distills into linked, plain-markdown notes — concepts, entities, decisions, dead-ends. Even solo, even if you never share a thing, you walk away with a personal knowledge base of everything your agents figured out. The Karpathy-style append-only brain every engineer wishes they'd kept — except Contexo writes it for you.
A 4,000-line CLAUDE.md that everyone edits and no-one owns isn't a knowledge base — it's a liability. Contexo gives agent context the discipline of a repo: history, diffs, review, a single source of truth.
— why we built Contexo
Free for small projects on our hosted server. During the beta, just $5/mo per owner (50% off) unlocks unlimited repos and members. Self-host on your own infra for free, forever.
Use our online Contexo server for small-to-medium projects — no infra to deploy. Up to 5 repos and up to 3 members per repo.
No caps on repos or members. Owners subscribe; everyone they invite gets full access — the team plays free.
Run Contexo on your own infra. The server and CLI are open source — clone the repo, deploy with Docker, never pay a per-seat tax.
Things we wish vendors told us about their tools, but they don't. So we will.
Git versions the file, not the behavior. More bigger the CLAUDE.md more ineffective it is, with contexo the context will be divided into reasonable chunk. Semantic diffs on prompts, scoped sharing across repos, and a single mount that every editor and agent reads from, without you maintaining six different rule files.
On Team, yes — encrypted at rest with a per-org key. On Org self-host, never; the data stays in your VPC. Either way, your context aren't used to train models. Ever.
First-class. .ctx/mcp/*.json is part of the contexto, we inject the mcp by default to your agent, this mcp basically just a guide for you agentic to use contexo, so if you're not feeling doing manual "git"-like task, just ask your AI Agent. Also will be compatible with major AI Agent provider*"
Yes. ctx link writes shims for Claude Code, Cursor, Windsurf, Codex, Continue — they all keep reading their own paths, you stop hand-syncing them.
Real CLI, written in Go, ships as one binary. The web app is for the extention of feature, just like git and git-hub. Everything you do day-to-day still happens in your terminal, but with the web app, you can check the context more easily
Pretty much to support the Web app, this contexo is personal project of mine, so i need support for you if you're enjoing the web app usage. But no cost for the local cli usage
Technical writing on version-controlling AI context — architecture, patterns, and the occasional opinion.
A deep dive into Contexo's engine: how the CLI and server stay LLM-free by handing distillation to the agent already in the loop (the push handshake), and how section-aware diffs make a page's history legible in a way git diff can't.
Six concrete scenarios where Contexo earns its place — walked through step by step, from the commands you run to the MCP handshakes your agent handles. Every step maps to what Contexo actually does today.
The one idea behind Contexo, and why we're starting this blog: the context your AI agents run on is code now — so it deserves diffs, history, and one shared source of truth. Here's the “context tax” it solves, what Contexo is, and how it works.
Free plan available, and 50% discount on team plan while on beta launch. Takes about as long to install as a fresh git config.