Claude Scheduled Tasks System

Summary

Built a "Claude Cowork"-style scheduled task system using systemd timers and claude -p headless mode. Allows fully autonomous Claude Code sessions to run on a schedule without human interaction.

Architecture

Universal runner: ~/.config/claude-scheduled/runner.sh
Per-task config directory: ~/.config/claude-scheduled/tasks/<name>/
- prompt.md — task instructions
- settings.json — model, budget, allowed tools
- mcp.json — MCP server config for that task
Systemd template unit: claude-scheduled@.service
Per-task timer files: claude-scheduled@<name>.timer

Key invocation flags

claude -p \
  --model sonnet \
  --max-budget-usd 0.75 \
  --output-format json \
  --no-session-persistence \
  --allowedTools <list> \
  --mcp-config <file> \
  --strict-mcp-config \
  --append-system-prompt <context>

Critical notes

Must unset CLAUDECODE before invoking claude -p inside any shell that may be a Claude session (nested session error otherwise)
--permission-mode bypassPermissions cannot be used as root — run as non-root user
--max-budget-usd is not an instant cutoff — can overshoot (set $0.25, spent $0.37)
Results stored to cognitive-memory as workflow+episode
Log rotation: keeps 30 logs per task in ~/.config/claude-scheduled/tasks/<name>/logs/
Global kill switch: create ~/.config/claude-scheduled/disabled file to halt all tasks

Gitea issue

claude-home#2

1.8 KiB Raw Blame History