`
┌─────────────────────────────────────────────────┐
│ │
│ Code → Learn → Save → Sync → Load │
│ ↑ │ │
│ └─────────────────────────────────────┘ │
│ │
│ Context grows with every cycle │
└─────────────────────────────────────────────────┘
`

Commands

$3

| Command | What it does |
|---------|--------------|
| ctx init | Initialize ctx in your project |
| ctx create | Create a new context file from template |
| ctx sync | Sync all contexts to registries |
| ctx check | Check context integrity and staleness |
| ctx status | Show context and work session status |
| ctx refresh | Refresh AI commands with current config |
| ctx session [file] | Extract messages from Claude Code session files |

#### Command Flags

ctx check
`bash
ctx check # Check all contexts
ctx check --local # Check local contexts only
ctx check --global # Check global contexts only
ctx check --fix # Auto-fix issues (run sync)
ctx check --pretty # Human-readable output
`

ctx status
`bash
ctx status # Show project status
ctx status --pretty # Human-readable output
ctx status --target src/api/ # Find context for a specific file
`

ctx create
`bash
ctx create src/api/routes.ctx.md # Create local context
ctx create ctx/rules/api.md --global # Create global context
ctx create --template custom.md # Use custom template
ctx create --force # Overwrite existing
`

$3

Once initialized, use these commands directly in Claude Code:

#### Core Commands

| Command | Purpose |
|---------|---------|
| /ctx.save [path] [description] | Save context (unified command for create/update) |
| /ctx.load | Load relevant contexts by description |
| /ctx.sync | Sync context registries |
| /ctx.status | Show current status |
| /ctx.audit [description] | Audit context files for issues |

#### /ctx.save - Unified Context Command

The /ctx.save command intelligently handles both local and global contexts:

`bash


Save local context (by context path)

#### /ctx.audit - Context Health Check

The /ctx.audit command performs comprehensive context health analysis:

`bash


Quick audit (mechanical checks only)

| Command | Purpose |
|---------|---------|
| /ctx.work.init | Start from GitHub/Linear issue or local requirements |
| /ctx.work.plan | Generate implementation plan |
| /ctx.work.extract | Extract insights back to context |
| /ctx.work.commit | Commit changes with context |
| /ctx.work.submit | Create PR and link to issue |

`bash


Start from online issue

After ctx init, your project will have:

`
your-project/
├── ctx.config.yaml ← Configuration file
├── ctx/ ← Global context directory
│ ├── README.md
│ ├── local-context-registry.yml
│ ├── global-context-registry.yml
│ ├── issues/ ← Work session issues
│ └── templates/ ← Customizable templates
├── .claude/
│ ├── commands/ ← AI commands (auto-installed)
│ │ ├── ctx.save.md
│ │ ├── ctx.load.md
│ │ ├── ctx.sync.md
│ │ └── ...
│ └── hooks/ ← Session tracking hooks
├── .ctx.current ← Active work session tracker
├── .worktrees/ ← Work session branches
└── src/
└── *.ctx.md ← Local context files
`

Configuration

ctx.config.yaml controls how ctx works:

`yaml
version: 0.1.0
editor: claude-code

local:
patterns:
- "*/.ctx.md"
- "**/ctx.md"
ignore:
- node_modules/**
- dist/**

global:
directory: ctx
patterns: "*/.md"
ignore:
- templates/**
- "*-context-registry.yml"
- issues/**

work:
directory: .worktrees

frontmatter:
local: optional # required | optional | none
global: optional
`

Editor Support

| Editor | Status |
|--------|--------|
| Claude Code | Supported |
| Cursor | Planned |
| Windsurf | Planned |

Advanced

$3

After ctx init, you can customize templates in ctx/templates/:

`
ctx/templates/
├── local-context.md ← Template for new local contexts
└── global-context.md ← Template for new global contexts
`

Edit these files to match your project's documentation style.

$3

AI command templates support reusable snippets with {{snippet:name}} syntax:

`markdown
{{snippet:errors}}
{{snippet:check-issues#section}}
`

Snippets are defined in src/templates/snippets/` and allow code reuse across AI commands.

---