michaelliv 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
# Via npm (requires Bun)
bunx 9to5 --help
# Or clone and install
git clone https://github.com/Michaelliv/9to5.git
cd 9to5 && bun install
# Run in dev mode
bun run dev -- <command>
# Build standalone binary
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
# edit the 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.
# View webhook config and URLs
9to5 webhook info
# Get ready-to-use curl commands for a specific agent
9to5 webhook url <agent-id>
# Regenerate the secret (breaks existing integrations)
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 # daemon triggers it daily at 9 AM
More examples in the examples/ directory — import any with 9to5 agent import examples/<name>.json.