Documentation
skep documentation
Start here
- 5-minute quickstart first run in 5 minutes
- Onboarding: skep onboard
skep onboard: model, work directory, sandbox, locked policy baseline, role — and--check - How to Use skep on a New Machine full source, serve, and Docker setup notes
- demo-gif.md the reproducible terminal demo recording
- Explaining skep to a human — a guide for agents for agents: explaining skep to a human (the operating half is
../SKILL.md)
Guides
- Guide: hand Claude Code or Codex a task and walk away hand Claude Code or Codex a task and walk away: sandbox, auth env, pinned verify command, run, evidence, approve, pull request
- Guide: dispatch a run from cron or a script start a run from cron or a script: the missing environment, exit codes,
skep schedule,skep tick, and whatskep servedoes itself - Guide: pin the command that proves the work pin the command that proves the work, and read the four re-verification results
- Guide: let confirmed runs land by themselves let confirmed runs land on a
skep/branch by themselves, and what that still refuses - Guide: run skep as an always-on assistant on Ubuntu 24.04 run skep always-on on an Ubuntu 24.04 server or home lab VM: bubblewrap under AppArmor, a systemd user service, a service account without sudo, and Telegram
Concepts
- How Skep Works the Queen/worker split, the contract, and the life of a task
- Sandboxing macOS Seatbelt and Linux bubblewrap, and the network allowlist boundary
- Codex runs on a ChatGPT plan login (ES-F120–F129) how a codex run uses a ChatGPT plan login without ever holding the refresh token
- Re-Verification independent patch re-verification (G10)
- Approvals and Learned Templates inline approvals and learned command templates
- The browser is an MCP server browser automation via a browse-scoped MCP server (Playwright), reads flow / acts card
Reference
- CLI Reference every command
- The policy enforcement hook (P3, ADR 0053) the policy enforcement hook:
decide()for outside agents (Claude Code PreToolUse), every verdict recorded - The ACP governor
skep acp govern: skep answers an ACP agent's permission asks inside another client (T3 Code), every verdict recorded - Configuration home, worker, policy, and model settings
- The brain dial — choosing the assistant model choosing the assistant model (the v72 dial: ollama, openai-compat, anthropic)
- Assistant tools — first-party mail and calendar (v72-F5) the first-party mail and calendar MCP servers (v72), and the registry-then-forge pattern
- skep in your pocket — the mobile story (v72-F6) approve from your phone: what a messenger can confirm, what stays web-UI-only, what pushes to you
- Daily-driver setup: skep from your phone the phone setup checklist: confirm from Telegram, research, YouTube summaries, the 16:30 mail summary;
skep doctornames each step still undone - Worker Adapters Claude Code, Codex, Aider, and the adapter contract
- skep version history per-version changelog
- competitive-analysis.md where skep stands in the 2026 agent landscape (the v72 round's seed)