# 9to5

> 9to5 — Automated agents for Claude Code

- Skill: `michaelliv/9to5` (Agent Skill)
- Install (CLI): `npx skillmds@latest add michaelliv/9to5`
- Raw SKILL.md: https://api.skillmd.com/api/skills/michaelliv/9to5/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: michaelliv (https://skillmd.com/u/michaelliv)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/michaelliv/9to5

---


# 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

```bash
# 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

```bash
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.

```bash
# 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 tables
- `daemon.pid` — PID file for the background daemon
- `webhook.secret` — HMAC secret for webhook triggers (auto-generated on first daemon start)
- `webhook.disabled` — Marker file indicating webhooks are explicitly disabled

## Example

```bash
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/`](https://github.com/Michaelliv/9to5/tree/main/examples) directory — import any with `9to5 agent import examples/<name>.json`.