AICTX - Repo-Local Continuity Runtime for Coding Agents

Welcome to AICTX documentation. This site is your complete guide to understanding, installing, and using AICTX.

What is AICTX?

AICTX helps coding agents maintain continuity across sessions. Instead of starting cold each time, agents resume from where they left off with:

• ✅ Active task state and next actions
• ✅ Known failures and workarounds
• ✅ Successful strategies from prior work
• ✅ Architectural decisions and context
• ✅ Repo-local evidence of progress

Quick Navigation

Getting Started

• Installation - Set up AICTX in your repository
• Quickstart - Get running in 5 minutes
• Demo - See real continuity in action

Understanding AICTX

• Technical Overview - How AICTX works internally
• Work State - Preserving task progress
• Failure Memory - Learning from mistakes
• Strategy Memory - Reusing what works

Advanced Topics

• RepoMap - Structural repository mapping
• Handoffs & Decisions - Explicit context transfer
• Execution Contracts - Compliance and auditing
• API Usage - Detailed command reference

Operations

• Safety - Trust and security considerations
• Limitations - What AICTX doesn’t do
• Cleanup - Maintaining your continuity store
• Upgrade Guide - Moving to new versions

Supported Agents

AICTX works with:

• 🤖 Codex - Full integration with repo instructions
• 🧠 Claude - Deep Claude.ai workspace support
• 🔧 Generic agents - CLI/JSON compatible with any coding agent

Why AICTX?

Without AICTX:

Session 1 → Do work → Chat ends
Session 2 → Start cold → Rediscover repo → Repeat mistakes

With AICTX:

Session 1 → Do work → Record continuity
Session 2 → Resume from capsule → Continue immediately

See the Demo for measured results.

Installation

pip install aictx
aictx install
aictx init

Then use your coding agent normally. AICTX handles continuity automatically.

See Installation for details.

Quick Example

Resume from last session:

aictx resume --repo . --task "continue parser work" --json

Returns continuity context:

Resuming: parser edge cases
Last progress: BLOCKED status added
Next: expand tests/test_parser.py
Known failure: pytest unavailable outside .venv
Suggested command: .venv/bin/python -m pytest -q

Then at the end of your session:

aictx finalize --repo . --status success --summary "Parser now handles all edge cases" --json

Community

• 💬 Discussions - Share ideas and get help
• 🐛 Issues - Report bugs or request features
• 📝 Contributing - Help build AICTX

License

MIT License - See LICENSE

---

Ready to get started? → Installation Guide