AI Context System

Appearance

Getting Started ​

Welcome to the AI Context System! This guide will help you install and start using the system in minutes.

What is AI Context System? ​

The AI Context System externalizes AI reasoning into visible, structured documentation that enables:

  • Session Continuity - Resume work exactly where you left off
  • Externalized Context - Make AI decisions and mental models visible
  • Human-AI Collaboration - Full visibility into AI thinking
  • AI-to-AI Collaboration - Seamless handoffs and peer review

Quick Installation ​

bash
# Install from GitHub
curl -sL https://raw.githubusercontent.com/rexkirshner/ai-context-system/main/install.sh | bash

# Initialize context
/init-context

Option 2: Manual Install ​

bash
# Clone the repository
git clone https://github.com/rexkirshner/ai-context-system.git

# Copy to your project
cp -r ai-context-system/.claude /path/to/your/project/
cp -r ai-context-system/scripts /path/to/your/project/
cp -r ai-context-system/templates /path/to/your/project/

# Initialize
/init-context

# Clean up
rm -rf ai-context-system

What Gets Created ​

After running /init-context, you'll have:

your-project/
├── CLAUDE.md                    # Claude Code entry point (auto-loaded)
├── context/
│   ├── .context-config.json     # Project configuration
│   ├── CONTEXT.md               # Project orientation
│   ├── STATUS.md                # Current state
│   ├── DECISIONS.md             # Decision log
│   └── SESSIONS.md              # History
├── .claude/
│   ├── commands/                # 22 slash commands
│   ├── agents/                  # 12 specialist agents
│   ├── schemas/                 # 7 JSON validation schemas
│   └── hooks/                   # Session automation
├── scripts/                     # Helper utilities
└── templates/                   # Documentation templates

Daily Workflow ​

bash
# Start your session (automatic health check runs first)
/review-context

# Work on your project...

# Save frequently (2-3 minutes)
/save

# Before breaks/handoffs (10-15 minutes)
/save-full

Automatic Health Checks

Starting in v5.0, a session-start hook automatically runs when you begin a Claude Code session. It checks context freshness, validates Quick Reference presence, and warns about unclosed sessions—all before you even type /review-context.

Next Steps ​

Requirements ​

For Claude Code users (full features):

  • Claude Code CLI
  • File system access
  • jq for JSON processing (brew install jq on macOS, apt install jq on Linux)

For other AI tools:

  • Any AI coding assistant with file system access
  • Manual use of templates and file structure
  • Reference appropriate tool header (cursor.md, aider.md, etc.)

Universal:

  • Any project (language/framework agnostic)
  • Git recommended but not required
  • Bash 3.2+ (macOS default) or compatible shell

Troubleshooting ​

Commands not working?

  • Check for multiple .claude directories
  • Only keep .claude in project root
  • Exception: Meta-projects intentionally have multiple

Need help?