Files
stack/agents/rocko
jason.woltjeandClaude Fable 5.1 69f99323c7 Add mosaic launch <seat> with seat registration for the control board (#1504)
New package packages/seat and wrapper scripts/mosaic. `launch <seat>` writes
<dataRoot>/seats/<layout>/<seat>/registration.json and then execs the seat's
launch.sh unchanged; `seat task <seat> <text>` edits the task only. The board
reads registrations, matches by sessions directory, and lets a registered
task, project or workspace override the derived value with a source tag.
The four repository launch scripts register themselves unless already
registered or run with --check. Fleet launchers untouched; one-liner on the
plan page.

Review found the record path keyed by seat name alone (repo and fleet
"darkwing" would collide); fixed by keying on layout. Also: the Pi pin
refusal now names installed and required versions.

Tests: seat 15, control-board 89, launch scripts 5, registry 69, config 24.

Co-Authored-By: Claude Fable 5.1 <[email protected]>
2026-09-12 10:56:17 -05:00
..

Rocko development TUI

Run from any terminal:

/mnt/storage/src/mosaic-stack/agents/rocko/launch.sh

Rocko handles general Mosaic Stack development assignments under team lead Darkwing. The launcher opens Claude Code in the repository with --model sonnet and the display name Rocko. Sonnet is the selected CLI model alias; Rocko's project persona is supplied by SOUL.md, not a separate custom Claude agent.

Use --check to validate the executable and context inputs without a model call. This does not verify authentication or account access to Sonnet. Claude Code uses its normal authentication, settings, permissions, and discovered resources; this script does not copy credentials or bypass permissions.

Normal launches resume the exact Claude UUID recorded locally in .pi/state/rocko/session-id. First launch creates a UUID; --fresh creates another while retaining previous conversations in Claude's native storage. Each private launch receipt under .pi/state/rocko/launches/ retains its UUID and context snapshot. The launcher lock refuses concurrent Rocko launches through this script; it does not lock sessions opened by other means.

If Claude exits before saving its first conversation, or its history is removed, the saved UUID may not be resumable. Inspect the failure and use --fresh explicitly to start again. The launcher does not fall back to the latest unrelated project conversation. Old UUIDs in launch receipts can be opened manually with claude --resume UUID from the project directory.

The prompt snapshot includes CONSTITUTION, STANDARDS, Rocko's SOUL, the live Mosaic user profile, root AGENTS.md, and Rocko's CONTEXT.md. --soul FILE, --constitution FILE, and --user FILE override individual inputs; relative paths resolve from the repository root. Missing or empty inputs refuse launch. The snapshot is appended to Claude's system prompt on each launch.

This is a host development session, not a managed fleet registration. It loads no Pi goal extension. The user or team lead supplies the assignment.