agent-afk

griffinwork40/agent-afk is an open-source project by griffinwork40: The coding agent you don’t have to watch. Start a task and walk away. AFK builds the feature, verifies its own work, and texts you when it’s done. You come back to a receipt of every step, every decision, and what’s waiting on you. If it’s unsure, it stops and asks instead of guessing.. Indexed here so it can be found — not resold.

It is free. Get it from the upstream repository: https://github.com/griffinwork40/agent-afk

From the project's own README (excerpt, reproduced for discovery under its Apache-2.0 license):

Agent AFK

Start a task and walk away. AFK builds the feature, verifies its own work, and texts you when it's done. You come back to a receipt of every step, every decision, and what's waiting on you.

Open source. Runs locally. Works with any model provider, including local models. Your keys, your machine, your rules.

Your browser does not support the video tag.

> ⭐ Like the idea of an agent you can walk away from? Star the repo -- it's the fastest way to help other people find it.

Quick Start

That's it. You're in.

Using pnpm? pnpm add -g agent-afk works, but pnpm 10 and later block build scripts by default and skips postinstall (with an easy-to-miss warning — see #2199). Run pnpm approve-builds -g after install to approve the hook, or use npm install -g agent-afk instead. If an afk daemon is already running and pnpm skipped the hook, restart it manually with afk service restart daemon — on macOS the hook restarts the daemon automatically when it runs, but on Linux you must always run this command after an upgrade even when the hook ran. If you have a manually-started Telegram bot, also run afk telegram restart.

Try without installing: npx agent-afk chat "hello" runs a one-shot turn with zero global install.

Already using Claude Code or Codex? afk login will detect your existing credentials automatically. Run afk migrate to import your plugins, skills, and MCP servers too -- it live-reads the source tool's dirs, so anything you install there keeps showing up in AFK with no re-run.

Codex imports use CODEXHOME when set (otherwise ~/.codex) and also discover shared skills in ~/.agents/skills. Native .codex-plugin/plugin.json manifests are recognized alongside Claude-format manifests; explicit [plugins."name@marketplace"] enable/disable…