wolfpack-tailnet-control

name	wolfpack-tailnet-control
description	Create top-level Wolfpack sessions, spawn child agents, and inspect or control local/Tailscale sessions through the canonical CLI.

Wolfpack Session Control

Use the canonical CLI. Do not discover or reconstruct browser/private HTTP flows. Wolfpack uses its ordinary global API auth policy and adds no inter-session authorization layer.

Fast path

A top-level project session:

wolfpack session create <project> --harness <pi|claude|codex|gemini|cursor> --prompt '<instruction>' --json

A same-harness child of the current agent:

wolfpack agent spawn <project> --plan .plans/000-task.md --notify-parent --json

wolfpack session open is only a deprecated child-spawn alias. Never use it for a top-level request. Both creation commands perform one server-owned request and pass startup instructions without inheriting parent transcript/context.

Prefer --plan <file> for plan work: Wolfpack generates the compact handoff prompt and verifies the file exists without copying plan contents into the parent transcript. Use --prompt-file <file> for long bespoke instructions. Use raw --prompt only for one short prompt sentence. Do NOT paste repository policy, architecture context, or full plans into the launch command.

Structured inspection and control

wolfpack list --json
wolfpack session status <session-or-id> --json
wolfpack session read <session-or-id> --json
wolfpack session send <session-or-id> '<text>' --json
wolfpack session wait <session-or-id> '<text>' --json

Treat session selectors as opaque handles. Prefer the stable sessionId returned by create/spawn/list/status. If the user already supplied an exact target, do not list first.

Read-only inspection is allowed when requested. Creation, sending input, killing, taking control, remote-host access, and notifications require explicit user intent for that action and target. Never scrape terminal/UI prose as protocol, bypass auth, guess tokens, or kill a mistaken session as cleanup without permission.

References — load only when needed

• command/API behavior: docs/session-control.md
• setup, auth, and Tailscale: README.md
• troubleshooting: docs/troubleshooting.md
• broker internals only when changing transport: docs/broker-protocol.md
• Ralph automation: skills/wolfpack-ralph/SKILL.md