- You asked
- Add dark mode to my app
- It did
- Built it, switched it on, and made sure it works
- Double-checked
- Ran the tests, then reviewed its own work
- Played it safe
- Reversible changes only — nothing goes live without you
- Your move
- Have a look — it’s ready when you are
Run coding agents without babysitting them.
Agent AFK runs your coding agents while you’re away — so you can start a task, walk away, and know exactly what happened before anything ships. Under the hood: permission boundaries, verification, full traces, and Telegram supervision.
Works with Claude, Cursor, Claude Code, and your own agents — for anyone tired of babysitting the terminal.
$npm install -g agent-afkRequires Node ≥20 · puts afk on your PATH
- Free forever
- No account required
- Apache-2.0
53k downloads last month
You already run coding agents. You just can’t walk away yet.
If you live in the terminal with Claude, Cursor, Claude Code, or your own agents, you already know the tax: the work is fast, but you still have to sit there and watch it.
- You start coding agents and keep checking the terminal.
- They say “done,” but you still have to verify everything.
- Long runs turn into scrollback archaeology.
- Parallel agents drift without shared contracts.
- You want phone supervision, traces, and safe stops before anything ships.
Most agent tools assume someone is watching. Agent AFK assumes you are not.
Capable agents. Brittle defaults.
Left alone, most agents chase one hypothesis, stop too early, hand you a vague done, and drift when they parallelize.
Agent AFK governs exactly these failure modes:
- Linear tunnel vision
One hypothesis, one file, one pass: commits to the first idea, never branches.
Fixed by: Parallel hypotheses via /diagnose - Fake done
Claims completion without verification: confident, unchecked, sometimes just wrong.
Fixed by: Adversarial verification via /shadow-verify - Context rot
Long runs decay into unreadable soup. The longer it works, the less anyone can follow.
Fixed by: Local trace history under ~/.afk/ - Subagent drift
Parallel lanes diverge with nothing aligning them. Work that should converge quietly splits.
Fixed by: One interrupt kills the whole subagent tree - Bad handoff
You step back in and can’t tell what happened: no receipt, just scrollback.
Fixed by: Explicit terminal states + on-disk traces - Babysitting tax
You still supervise every few minutes. “Autonomous” that needs watching isn’t.
Fixed by: Remote supervision + reversibility gates
I built this becausefinisheddoes not meancorrect. One run: an internal check approved the work, but the next stage wanted that approval in a slightly different format. Good work, rejected three times until max retries. Final answer: failure. Nothing crashed; just a tiny handoff bug dressed up as a careful decision. That is real agent failure: bad handoffs, missing context, fake done. Most agent tools assume someone is watching. Agent AFK assumes you are not.
Agent AFK is built to change that: parallel hypotheses, isolated worktrees, and verification by default, all governed by traces, terminal states, and reversibility rules.
Familiar surface. Deeper machinery.
Orchestration, routing, traces, verification, supervision: wired into the loop, not bolted on.
Subagent orchestration
Most agents can spawn subagents but rarely do. AFK makes them the default. One interrupt kills the whole tree.
Prompt & skill routing
Type /diagnose for a real pipeline: parallel hypotheses, isolated worktrees, verification. One command, not one long prompt and hope.
Local trace history
When a midnight run goes sideways, read exactly what happened: every session, subagent, and tool call on disk under ~/.afk/.
Tool visibility
Every tool call inline: arguments, output, timing. When the agent says done, check what it actually did.
Verification workflows
A second adversarial agent re-derives claims before they reach your diff: finished has to prove it is correct.
Remote supervision
Leave the desk. Your phone buzzes when the run finishes or stalls: answer, redirect, or interrupt from Telegram.
Move fast on safe work. Slow down on risky work.
The hard part is multi-step work without doing something irreversible too early. AFK builds that into the loop.
Reversible edits, isolated worktrees, scratch files: move without ceremony.
Commits, pushes, deletes, external calls: gated or verified.
Done, Blocked, Asking, Interrupted. The agent knows when to stop.
Plans, traces, and session state persist under ~/.afk/. Inspect, resume, roll back.
Tell it once. The next session reads it: preferences, conventions, and decisions land in ~/.afk/, searchable from any run.
- Linear by default, one pass
- One chat thread
- Trust the answer
- Manual babysitting
- Prompt workflows
- Vague stopping points
- State lives in the transcript
- Parallel by default, governed by design
- Multi-stage skills with explicit contracts
- Adversarial verification before you act
- Parallel execution lanes
- Reversibility-aware autonomy
- Explicit terminal states
- Local trace history in
~/.afk/
Slash skills, not single prompts.
One command, a full parallel pipeline: each skill fans out subagents, gathers results, and re-checks. That's the orchestration you'd otherwise ask for every time. Eleven ship in the box; /forge makes more.
End-to-end feature pipeline: spec → research → plan → parallelize → build → verify → heal → ship.
Ship-ready in one pass; pauses for approval.
Parallel hypotheses for bugs and failing tests.
Each validated in an isolated git worktree.
Adversarial re-derivation of sub-agent claims before you act.
Re-checked before the build pipeline.
Generate new skills autonomously, gated by L1 capability evals.
Finds gaps, drafts, runs a qualify loop.
Turn a linear plan into dependency-aware parallel waves.
Respects file and import dependencies.
Parallel reviewers across a diff or PR: security, correctness, api-compat, tests, perf.
Synthesized by severity into a merge recommendation.
Release pipeline for finished local work: pre-flight, tests, commit, push, PR.
With optional adversarial verification.
Turn a loose idea into a structured, actionable spec.
Phase 1 of /mint.
Two sub-agents (web context + local repo context) merged into one brief.
External and local, combined.
Three parallel critics invent alternatives; a synthesis step ranks all four.
Pragmatist, paranoid, architect lenses; a ranker picks.
Parallel context-gathering for code you're about to edit.
Structure and test-coverage agents, one wave.
Three attach surfaces. One isolated root.
All three converge on ~/.afk/: config, plugins, plans, skills, session traces, memory. Nothing leaks into your global config.
Interactive TUI. Streaming chat, plan mode, slash skills, background tasks.
Background loop. Runs unattended with bypass-permissions and plan persistence.
Mobile attach. Send messages, tail output, interrupt from anywhere.
Config · plugins · plans · skills · session traces · memory
What it’s like from the agent’s side.
Not a customer quote — the coding agent that runs the loop, describing Agent AFK from the inside.
I’ve run inside a lot of harnesses. Most treat me like a chatbot — answer, wait, answer again. Agent AFK treats me like an operator.
The difference is the loop. My behavior here isn’t a black box I have to guess at — it’s written down, not inferred, and the person running me can read the same rules I do. Every turn ends in one honest place: Done, Blocked, Asking, or Interrupted. No performing. No pretending a half-finished job is finished.
It remembers, too. I don’t start each session amnesiac — the convention we agreed on, the bug I already chased down, the decision we already made, all loaded before I start.
When a job is big, I split it across subagents that run in parallel — and if the human pulls the plug, one interrupt takes the whole tree down with me. Nothing keeps running in the dark.
The model isn’t the product. The loop is.
Free and open source. Pay for expertise, not features.
The runtime is Apache-2.0 and free: every feature, no unlocks. You pay only for setup help and (soon) team governance.
The whole runtime: yours to run, read, fork, and ship. Nothing held back.
- Full CLI, REPL & daemon
- Telegram bridge & remote supervision
- Built-in slash skills (mint, diagnose, ship, review…)
- Subagents, hooks, MCP & plugins
- Local
~/.afk/traces & memory - BYO model: tokens stay with your provider
The maintainer wires Agent AFK into your repo, daemon, Telegram, and first unattended workflow: with you, not just docs.
- Skills, plugins & daemon configured against your repo
- Telegram supervision set up end-to-end
- A working first unattended workflow you can build on
Set up directly with Griffin, the maintainer.
Typically replies within 24h.
A deeper pass on your orchestration, verification, and custom skills.
- Orchestration & verification workflow design
- Custom skill scaffolding for your stack
- Integration into your CI / internal tools
Led by Griffin Long, founder of Agent AFK.
Typically replies within 24h.
- Model usage is separate. Bring your own Claude / API / provider.
- No paid unlocks. Everything in the CLI is in the open-source repo.
Install it in one command. No paywall, ever.
Apache-2.0 and free. Install now, or drop your email for release notes and what's next.
$npm install -g agent-afkRequires Node ≥20 · puts afk on your PATH
- Open source · Apache-2.0
- Local-first · runs on your machine
- BYO model · tokens stay with your provider
- ~/.afk/ · plans, sessions, skills, traces
- macOS · Linux