← ClaudeAtlas

shadok-ai-agentslisted

Create and drive isolated Claude Code agents through the shadok-ai server (git worktrees, prompts, dialogs, diff). Use when the user wants to delegate a task to a shadok-ai agent, launch agents in parallel, or inspect/drive existing shadok-ai sessions.
shadok-ai/shadok-ai · ★ 14 · AI & Automation · score 76
Install: claude install-skill shadok-ai/shadok-ai
# Driving shadok-ai agents Every operation goes through the thin client shipped with this skill: ```bash node ~/.claude/skills/shadok-ai-agents/pilotctl.mjs <command> … ``` Each command prints ONE JSON object on stdout (exit 1 + `{error}` on failure) and automatically starts the shadok-ai server when it is not running (port 3789, or `$SHADOK_PORT`). Sessions stay visible in the web UI (http://localhost:3789) — the user can follow along and step in. ## Commands | Command | Effect | |---|---| | `spawn [--cwd DIR] [--worktree] [--profile NAME] [--resume ID] [--continue]` | creates an agent → `{sessionId, cwd, branch}`. `--worktree` isolates the agent in a git worktree (`~/.shadok-ai/worktrees/`, branch `shadok-ai/<tag>`). `--profile` gives it a role + its guardrails + its secrets (see below) | | `prompt <id> "text" [--timeout s]` | sends a prompt, waits for the end of the turn → `{status:"answer", text, tools}` or `{status:"dialog", question, options, multi}` or `{status:"timeout", screen}` or `{status:"pace-blocked", reason}` | | `dialog <id>` | queries the state → `{status:"idle"}` or the pending dialog | | `choose <id> <n>` | single-select dialog: picks and commits option n | | `toggle <id> <n>` then `confirm <id>` | multi-select dialog: check/uncheck then submit | | `freetext <id> <n> "text"` | the "Type something" option: a free answer | | `list [--cwd DIR]` | driven agents (local state + alive/dead) and resumable sessions | | `diff <id>` | the agent's changes (git sta