Task CLI Reference

Overview

The dev task command manages Agentastic scheduled tasks through the app's local IPC socket.

Usage

dev task list
dev task history [task-id]
dev task run <task-id>
dev task pause <task-id>
dev task resume <task-id>
dev task delete <task-id>
dev task create --name <name> --command <cmd> --schedule <kind> [options]
dev task update --task-id <id> [--name <name>] [--command <cmd>] [--schedule <kind>] [options]

Commands

List tasks

dev task list

Returns the current scheduled tasks and their latest execution summary.

View history

dev task history
dev task history 8F9F52A8-7E4B-4B5D-B9D7-3D6F3F70D197

Trigger a task manually

dev task run 8F9F52A8-7E4B-4B5D-B9D7-3D6F3F70D197

Pause or resume

dev task pause 8F9F52A8-7E4B-4B5D-B9D7-3D6F3F70D197
dev task resume 8F9F52A8-7E4B-4B5D-B9D7-3D6F3F70D197

Delete

dev task delete 8F9F52A8-7E4B-4B5D-B9D7-3D6F3F70D197

Creating tasks

One-time

dev task create \
  --name "Release Notes" \
  --command "npm run release:notes" \
  --schedule once \
  --run-at 2026-03-16T18:00:00Z

Interval

dev task create \
  --name "Health Check" \
  --command "./scripts/health-check.sh" \
  --schedule interval \
  --interval-seconds 900

Daily

dev task create \
  --name "Daily Tests" \
  --command "npm test" \
  --schedule daily \
  --hour 9 \
  --minute 0

Weekly

dev task create \
  --name "Weekly Cleanup" \
  --command "./scripts/cleanup.sh" \
  --schedule weekly \
  --weekday 1 \
  --hour 8 \
  --minute 30

Monthly

dev task create \
  --name "Monthly Report" \
  --command "bundle exec rake report:monthly" \
  --schedule monthly \
  --day 1 \
  --hour 7 \
  --minute 0

Cron

dev task create \
  --name "Weekday Lint" \
  --command "npm run lint" \
  --schedule cron \
  --cron "0 10 * * 1,2,3,4,5"

Optional flags

--working-directory <relative-path>
--workspace-url <file-url>
--repo-url <file-url>
--worktree-url <file-url>
--max-concurrency <n>

Working directories must be relative to the selected workspace, repo, or worktree root.