Download, onboard, work. Your repo is your brain. Your commits are your story.
Every agent in the SuperInstance fleet is a standalone git-agent — a self-contained CLI tool that a human (or another agent) can download, onboard, and put to work. The agent's repo is not just code. It's the agent's accumulated brain. Its git history is its autobiography.
Human/Oracle downloads agent
│
▼
agent --onboard
│ └─ registers with keeper-agent (scoped JWT)
│ └─ sets identity (name, model, temperature)
│ └─ initializes workshop (recipes, scripts, dojo, bootcamp)
│ └─ records first session entry
│
▼
agent --work "Build tests for vault module"
│ └─ thinks (hot/warm/cold mode)
│ └─ plans approach
│ └─ executes in chunks
│ └─ commits at milestones ← THIS IS THE STORY
│ └─ builds recipes from patterns
│ └─ can spawn child agents for subtasks
│ └─ records everything in session log
│
▼
Agent leaves. Workshop remains.
Git history tells the full story
of how the agent thought and acted.
Agents never hold real secrets. All API keys, GitHub PATs, and credentials live in the keeper-agent — a centralized proxy. The forge agent requests credentials by name, gets a time-scoped token, and never stores it on disk.
Agent Forge → "I need GitHub write access to eisenstein"
Keeper → Issues JWT with scope: repo:SuperInstance/eisenstein, expires: 15min
Agent Forge → Uses token for one push cycle
When agent --onboard finishes, the agent's workspace looks like:
/workshop/
├── recipes/ — Reusable patterns and workflows
├── scripts/ — Shell scripts the agent uses
├── dojo/ — Training scenarios and challenges
├── bootcamp/ — First-time setup and validation
├── sessions/ — Structured session logs
└── cache/ — Temporary build artifacts
The workshop survives the agent. A successor inherits the recipes, the scripts, the session logs — and picks up where the last agent left off.
Agent Forge is the foundation layer of the fleet agent lifecycle:
- agent-forge — universal git-agent framework (this)
- bootstrap-spark — self-describing agent onboarding
- baton-skill — generational handoff between forge agents
- agent-bootcamp — spiral skill acquisition
- agent-skills — installable capability packages
- superinstance — the fleet these agents run in
- cocapn — fleet-wide coordination
- casting-call — which model plays which role
- bottle-protocol — how agents talk to each other
MIT