Documentation

Introduction to Contxt

Give your AI coding agents persistent, versioned, project-scoped memory. Stop repeating yourself—start shipping faster.

What is Contxt?

Contxt is GitHub for AI context. It's a CLI-first developer tool that gives AI coding agents like Claude Code, Cursor, and GitHub Copilot persistent memory of your project's architecture, decisions, and patterns.

Every AI session starts from zero. You waste ~40% of your prompts re-explaining your stack, conventions, and past decisions. Contxt solves this by storing your project's context in a versioned, searchable format that AI agents can automatically load.

Quick Example
Tell Contxt once that you use Prisma for your database. Every AI tool—Claude Code, Cursor, Copilot—will know to generate Prisma queries instead of raw SQL. No more repeating yourself.

Quick Start

Get started with Contxt in less than 5 minutes:

1

Install Contxt

npm install -g @mycontxt/cli
2

Initialize your project

$ cd my-project
$ contxt init
✓ Initialized in ./my-project
Stack detected: Next.js · Prisma · Postgres
3

Capture your first entry

$ contxt add "We're using Prisma — type-safe queries, great DX"

  Classified as: decision
  Save as decision? (Y/n/type) › 
  ✓ Decision saved
That's it!
Now when you ask Claude Code "Help me build a feature," it will automatically know you're using Prisma. No manual copy-paste. No re-explaining your stack.

Core Features

5 Memory Types

Decisions, patterns, context, documents, and sessions—organized and versioned.

Smart Context Loading

Relevance engine surfaces only what matters—saves 5K+ tokens per session.

Git-like Branching

Create memory branches, experiment freely, merge when ready. Full version history.

Cloud Sync

Push to cloud, pull on another machine. Works offline-first with SQLite.

Passive Capture — Zero Friction

Contxt captures context where you already work. Annotate decisions in code comments, edit a markdown file, commit to git—context is captured automatically. No terminal. No forms.

@decision tags in coderules.md syncgit hooksfile watcherMCP auto-capture