Home

saipen

Cross-agent continuity protocol + project management. One command. Zero dependencies. Zero amnesia. Any AI agent picks up where another left off — across vendors, sessions, continents.

Why saipen?

AI agents lose memory when context resets. SAIPEN externalizes state into persistent .saipen/ directory — any agent reads, writes, resumes.

Problem	Without	With saipen
Switch Claude→Gemini	Re-brief from scratch	saipen continue — resumes
Session ends at 2 AM	"What was I doing?"	STATE.md: phase BUILD, task T-14
Agent crashes	Stale state, manual recovery	RFC 1.5 auto-detect, reclaim, resume
3 tools, 1 project	Context silos	Shared .saipen/ — one memory
Mid-feature bug sweep	Context switch	saihunt — parallel subSaipen, OUTBOX collected

How it works

project-root/
  .saipen/
    STATE.md        # Current phase, task, next_action, blocker
    BOARD.md        # DOING / TODO / DONE / BLOCKED
    LOG.md          # Append-only event graph (E-###)
    kitchen/        # Scratch workspace
    recovery/       # Crash snapshots
    logs/           # Sealed LOG history
    saitranslate/   # Translation bundle
    extensions/subs/  # SubSaipen agents
  saipen/
    RFC.md, BOOT.md, STYLE.md, CONFORMANCE.md
    phases/         # Phase rule definitions
    tools/          # validate.py, install_hook.py, run_scenarios.py
  VERSION           # Semver

1. Agent reads BOOT.md → STATE.md → BOARD.md → LOG.md tail
2. Executes STATE.next_action immediately
3. Transitions: PLAN → SCOUT → BUILD → VERIFY → REVIEW → SHIP → DONE
4. After each ticket: LOG → BOARD → STATE checkpoint

Key features

• Agent-agnostic — Claude, Gemini, Codex, Aider, DeepSeek, Qwen, any markdown reader
• Portable — one command, zero deps, one .saipen/ dir
• Phase-driven — structured pipeline PLAN→DONE
• Goal mode — multi-wave execution (3 wave / 20 ticket caps)
• SubSaipen — delegatable read-only sub-agents for parallel tasks
• Crash-recovery — auto-detect stale state, restore from recovery
• Multi-platform — Linux, macOS, Windows (PS + bash)
• CI-ready — pre-commit hook, validate.py, test scenarios

Learn more

• Getting Started — setup in 3 commands
• Phases — 16-phase reference
• Scenarios — 8 workflow walkthroughs
• Tutorials — 7 step-by-step guides
• Use-Cases — 10 real-world patterns
• SubSaipen — sub-agent roles + lifecycle

External:

• RFC — full protocol
• BOOT — cold-start kernel
• STYLE — communication voice
• GUIDE — user guide
• SPEC — technical spec
• CHANGELOG — full history

Version

v7.82.0 — One command. Zero dependencies. Zero amnesia. — MIT