40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# Rocko development TUI
|
|
|
|
Run from any terminal:
|
|
|
|
```sh
|
|
/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.
|