Files
stack/agents/rocko
jason.woltjeandClaude Opus 5.5 71d874764a feat(runs): read-only runs and releases reader module (#1545, row 56)
New packages/runs reads run records, result.json, the release pointer
and the activation log without writing, pruning or following a link out
of the data root. mosaic-task.mjs list and show use it, so a malformed
result.json or a run that is a regular file no longer crashes them.
Deliberate deltas are listed in the README.

Rocko built it. Round 1 (ed3c5392) was approved with notes by Darkwing
(27115) and Filbert (27116); round 2 (2727198f, tests and wording only)
was approved by Darkwing (27123) and Filbert (27124). Sage's gate on
c9a25a47 plus the candidate: runs 41/0, queue 148/0, webui 22/0,
conversation 182/0 (181/1 in the full run on the K12 cgroup timing
test under load, 182/0 alone), control-board 124/0, every
scripts/test-*.sh 0 failed (task 98/0 with Docker, 26/0 without).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-10 12:22:37 -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 project lead Sage. 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.