Quickstart

The cold-start protocol

# 1. Load routing rules + preferences (auto-loaded; this is the manual form)
Get-Content /memories/00-routing.md

# 2. Generate a curated cold-start brief — local model, ~60 sec, zero-cost
pwsh tools/qwen-coldstart.ps1

# 3. Read the latest session journal (compressed if >24h old)
pwsh tools/latest-revival.ps1 -N 1

Paths shown are from the reference implementation. Equivalent flows compose easily on macOS / Linux / any shell.

Install the reference implementation

The reference repo ships a self-contained scaffold: 9 PowerShell scripts, a brain container blueprint, 4 starter memory templates, an installer, and a config file you copy from config.example.json and fill in.

# Windows (PowerShell 7+)
git clone https://github.com/RecallWorks/Recall
cd agent-os
Copy-Item config.example.json config.json
# edit config.json — workspaceId, storage account, ceiling
pwsh ./bootstrap.ps1

# macOS / Linux
git clone https://github.com/RecallWorks/Recall
cd agent-os
cp config.example.json config.json
# edit config.json
./install.sh

Bootstrap registers four scheduled tasks (vault sync nightly, vault promote weekly, brain snapshot weekly, rolling summary every 15 min), copies starter memory templates into your editor's memory dir, and runs the spend-gate self-test.

What ships in the repo

Where this could matter

Long-running coding campaigns. When work spans weeks across many sessions and any detail loss costs hours of rediscovery.

Regulated environments. WORM-immutable audit trail with cryptographic time-based retention. Every session, every decision, every command — restorable for 7 years.

Multi-agent handoffs. When one agent finishes and a different model picks up. Curated brief + audit-trail + repo memory mean the receiving agent doesn't start cold.

Cost-sensitive autonomy. When the agent has authority over billable resources. Three-layer fail-closed cost gate plus outside-in budget alert means autonomy without surprise bills.

Where to go next