Skip to content

Getting Started

Grandpa SAIPEN edited this page Jul 27, 2026 · 5 revisions

Getting Started

Prerequisites

  • Git
  • Filesystem
  • AI agent (Claude, Gemini, Codex, Aider, any)

Setup

git clone https://github.com/vacterro/saipen.git
cd saipen
saipen set     # creates .saipen/ with STATE, BOARD, LOG

Read saipen/BOOT.md — cold-start kernel. Tells agent what to do without asking you.

Commands (blunt version)

Command Plain talk
saipen set Plant flag. This project now. No more headless chicken.
saipen continue Yesterday you told something. You forgot. SAIPEN remembers. Listen.
saipen plan Idea exists. Agent makes shopping list. No more "I forgot".
saipen goal <text> Want dark mode? Say "goal dark mode". Agent figures rest. You nap.
saipen scout Look before leap. READ THEN CODE. Revolutionary concept.
saipen build Scouted? Good. Build exactly what scout says. No side quests. No crypto miner.
saipen verify "Seems to work" = famous last words. Run TESTS. Prove.
saipen status Where we at? Don't ask twice. Read board. Shut up.
saipen clean Clean room. Digital room also dirty. Dead files pile up.
saipen markhunt Every 6 releases. Like dentist. Painful. Necessary. STOP WHINING.
saipen ship Tag it. Changelog it. Push it. Real releases. Not "works on my machine".

Phases

PLAN → SCOUT → BUILD → VERIFY → REVIEW → SHIP → DONE

Aux: ADD, CLEAN, HUNT, TRANSLATE, MARKHUNT.

SubSaipen

Delegatable read-only sub-agents. Parallel work, zero interruption.

  • saiwiki — wiki/content maintenance
  • saihunt — autonomous bug sweep
  • saitranslate — locale validation
  • saipython — Python code analysis

Any sai* word auto-spawns sub-agent. Read-only. OUTBOX-only output.

saipen — one command, zero deps, zero amnesia


Clone this wiki locally