DOCS
Every doc is a reference of something that already ships. Read in order for the full picture, or jump to what you need — historical decisions live in commits, planned work in the ROADMAP.
README.md
Start here. What alpi is, who it's for, how it differs.
read → 02 · guideQUICKSTART.md
Install, set a key, first chat, first skill. 5 minutes from zero to a working agent.
read → 03 · guidePROFILES.md
Switchable agent personalities: personal / coder / ops / research. How to define your own.
read → 04 · guideSKILLS.md
Directory contract. 13 closed categories. Frontmatter. Where secrets live.
read → 05 · guideMODELS.md
Tiers A/B/C. Usage signals + hands-on testing. What @soyjavi uses day to day.
read → 06 · referenceALP.md
Alpi Link Protocol. Noise-encrypted inter-machine transport. Rooms, rate limits, budgets.
read → 07 · referenceARCHITECTURE.md
Code structure, turn loop, memory, sessions, gateway, scheduler, MCP, logging.
read → 08 · referenceCONFIG.md
Every YAML knob, its default, what it controls.
read → 09 · referenceSECURITY.md
Two-layer security model. Approval system, SSRF, prompt-injection, sensitive paths. Sandbox.
read → 10 · opsDEPLOYMENTS.md
launchd on macOS, systemd on Linux. Gateway daemon, schedule daemon, keep-alive, logs.
read → 11 · opsOPERATIONS.md
Day-2 runbook. Doctor, diagnostics, log rotation, backup, recovery, upgrade.
read → 12 · legalLICENSE.md
BSL 1.1 for the agent core; Apache-2.0 for the Alpi Link Protocol.
read → 13 · planningROADMAP.md
What's in progress, what's coming in v0.3, decisions discarded with rationale.
read → 14 · logCHANGELOG.md
Version-by-version log of user-visible changes since v0.1.
read →