Installation

$ npx skills add smithery/dnvriend --skill skill-claude-code-scheduler

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared

Cursor Not declared

Codex Not declared

GitHub Copilot Not declared

Windsurf Not declared

Gemini CLI Not declared

Cline Not declared

OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

skill md SKILL.md 3,191 B

docs SUMMARY.md 75 B

SKILL.md

When to Use

Schedule and automate Claude Code CLI sessions
Manage jobs, tasks, runs, and profiles
Implement redundant worker patterns for AI-assisted coding
Interact with the scheduler's REST API
Use agentic coding patterns (/plan, /orchestrate, /qc, /finalize)

claude-code-scheduler

GUI application and CLI tool for scheduling and managing Claude Code CLI sessions.

Quick Start

# Launch GUI
claude-code-scheduler gui

# Check health
curl http://127.0.0.1:5679/api/health

# List jobs
claude-code-scheduler cli jobs list

# Run a job
curl -X POST http://127.0.0.1:5679/api/jobs/{id}/run

Data Model

Job (1) → Task (many) → Run (many)

Job: Container for related tasks
Task: A scheduled Claude Code command
Run: An execution record

Key Settings

Setting	Value
REST API URL	`http://127.0.0.1:5679`
ZAI Profile ID	`5270805b-3731-41da-8710-fe765f2e58be`
GUI Port	5679
Daemon Port	8787

Data Storage

~/.claude-scheduler/
├── jobs.json
├── tasks.json
├── runs.json
├── profiles.json
└── settings.json

Common Operations

Create Job

curl -X POST -H "Content-Type: application/json" \
  -d '{"name":"My Job","profile":"5270805b-3731-41da-8710-fe765f2e58be"}' \
  http://127.0.0.1:5679/api/jobs

Create Task

curl -X POST -H "Content-Type: application/json" \
  -d '{"job_id":"<uuid>","name":"My Task","prompt":"your prompt here","model":"sonnet"}' \
  http://127.0.0.1:5679/api/tasks

Create Task via CLI (with profile shortcuts)

# Use --zai for Z.AI profile
claude-code-scheduler cli tasks create \
    --name "My Task" --prompt "your prompt here" --zai --job <job-id>

# Use --bedrock for AWS Bedrock profile
claude-code-scheduler cli tasks create \
    --name "My Task" --prompt "your prompt here" --bedrock --job <job-id>

Run Job

curl -X POST http://127.0.0.1:5679/api/jobs/{id}/run

Agentic Patterns

Command	Purpose
`/plan`	Interview user, create Job→Task breakdown
`/orchestrate`	Execute job with parallel workers
`/qc`	Quality check candidates
`/finalize`	Move winner, cleanup
`/retry-until-green`	Retry until QC passes

References

For detailed information, read these files:

{baseDir}/references/data-model.md - Complete data model and field definitions
{baseDir}/references/cli-commands.md - Full CLI command reference
{baseDir}/references/rest-api.md - REST API endpoints and examples
{baseDir}/references/installation.md - Installation, shell completion, prerequisites
{baseDir}/references/development.md - Development workflow, code style, security
{baseDir}/references/troubleshooting.md - Common issues and solutions
{baseDir}/references/aws-infrastructure.md - AWS IaC with Pulumi
{baseDir}/references/distributed-nodes.md - Worker nodes, SQS/SNS, monitoring
{baseDir}/references/agentic-patterns.md - Redundant worker patterns (/plan, /orchestrate)

skill-claude-code-scheduler