| name | 9to5 |
| description | Automated agents for Claude Code. Use when the user wants to create agents, manage recurring AI agent runs, view run history, check their inbox, start/stop the background daemon, trigger agents via webhooks, or use the 9to5 TUI dashboard. Keywords: agents, schedule, cron, automation, recurring tasks, daemon, background jobs, webhook, trigger, CI, GitHub Actions. |
9to5 — Automated agents for Claude Code
9to5 is a CLI + TUI for creating automated Claude Code agents. Define an agent with a prompt, schedule, budget cap, and system prompt. Trigger it on a schedule, from a webhook, or on demand. A background daemon runs them automatically. Results land in an inbox with cost and duration tracking.
When to use this skill
Use this skill when the user wants to:
- Create automated Claude Code agents that run on a schedule or via webhook
- Create, edit, list, pause, or remove agents
- Trigger an agent manually or resume a previous run's session
- Trigger agents from external sources (GitHub Actions, CI, scripts) via webhooks
- View run history and execution results
- Check inbox notifications from completed runs
- Start or stop the background daemon
- Export or import agent configurations
- Launch the interactive TUI dashboard
Installation
bunx 9to5 --help
git clone https://github.com/Michaelliv/9to5.git
cd 9to5 && bun install
bun run dev -- <command>
bun run build
./9to5 <command>
Commands
Agent management (9to5 agent)
| Command | Description |
|---|
9to5 agent add <name> | Create a new agent |
9to5 agent edit <id> | Edit an existing agent |
9to5 agent list | List your agents with status and next run time |
9to5 agent run <id> | Run an agent now |
9to5 agent remove <id> | Remove an agent and its runs/inbox items |
9to5 agent restore <id> | Restore a deleted agent |
9to5 agent hide <id> | Hide an agent from list and TUI views |
9to5 agent unhide <id> | Unhide a hidden agent |
9to5 agent export [id] | Export agent(s) as JSON |
9to5 agent import <file> | Import agents from JSON (--update to merge by name) |
Runs & inbox
| Command | Description |
|---|
9to5 runs [agent-id] | View run history (all or filtered by agent) |
9to5 resume <run-id> | Resume the Claude Code session from a previous run |
9to5 inbox | Check your inbox |
Daemon (9to5 daemon)
| Command | Description |
|---|
9to5 daemon start | Start the background daemon |
9to5 daemon stop | Stop the background daemon |
Webhooks (9to5 webhook)
| Command | Description |
|---|
9to5 webhook info | Show webhook configuration and URLs |
9to5 webhook refresh | Regenerate the webhook secret |
9to5 webhook enable | Enable webhook triggers |
9to5 webhook disable | Disable webhook triggers |
9to5 webhook url <id> | Print ready-to-use trigger commands for an agent |
Options for agent add and agent edit
| Option | Description | Default |
|---|
--prompt <prompt> | The instruction Claude Code will execute | Required |
--cwd <dir> | Working directory for the run | Current directory |
--rrule <rule> | RFC 5545 recurrence rule | None (manual only) |
--model <model> | Claude model (sonnet, opus, haiku) | sonnet |
--max-budget-usd <n> | Max spend per run in USD | None |
--allowed-tools <t> | Comma-separated tool allowlist | All tools |
--system-prompt <p> | Appended to Claude's system prompt | None |
--status <s> | active or paused (edit only) | active |
Schedule format (rrule)
Schedules use RFC 5545 recurrence rules. Examples:
| Rule | Meaning |
|---|
FREQ=DAILY;BYHOUR=9 | Daily at 9 AM |
FREQ=HOURLY;INTERVAL=4 | Every 4 hours |
FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR;BYHOUR=10 | Weekdays at 10 AM |
FREQ=WEEKLY;BYDAY=MO;BYHOUR=9 | Mondays at 9 AM |
FREQ=MINUTELY;INTERVAL=30 | Every 30 minutes |
Without --rrule, agents are manual-only (9to5 agent run <id>) or webhook-triggered.
TUI dashboard
Launch with 9to5 ui. Two-column layout: list on the left, detail on the right.
| View | Hotkeys |
|---|
| Agents | r run, p pause/resume, dd delete, Enter drill into runs |
| Runs | c copy output, Enter view detail, Esc back |
Navigation: arrow keys or j/k, q to quit.
Editing via file
9to5 agent export <id> > agent.json
9to5 agent import agent.json --update
--update matches by name and applies changed fields.
Webhooks
Trigger agents from GitHub Actions, CI pipelines, or scripts on other machines. Two paths — local HTTP and remote via ntfy.sh — both secured with HMAC-SHA256 signing. No infrastructure to host, no accounts needed.
Webhooks are enabled by default — the daemon auto-generates a secret on first start. Use webhook disable to turn them off.
9to5 webhook info
9to5 webhook url <agent-id>
9to5 webhook refresh
Local trigger — POST http://localhost:9505/trigger/<id> with signed body and X-Signature header. For same-machine or local network scripts.
Remote trigger — POST to the ntfy.sh URL shown by webhook info. Works from anywhere. The daemon subscribes via SSE.
Both verify signatures and reject messages older than 5 minutes.
Data storage
All data lives in ~/.9to5/:
db.sqlite — SQLite database (WAL mode) with agents, runs, and inbox tablesdaemon.pid — PID file for the background daemonwebhook.secret — HMAC secret for webhook triggers (auto-generated on first daemon start)webhook.disabled — Marker file indicating webhooks are explicitly disabled
Example
9to5 agent add "morning-review" \
--prompt "Review yesterday's commits and summarize changes" \
--rrule "FREQ=DAILY;BYHOUR=9" \
--model sonnet \
--max-budget-usd 0.25
9to5 daemon start
More examples in the examples/ directory — import any with 9to5 agent import examples/<name>.json.
