clawdie-iso/live/operator-session/START-HERE.txt
Sam & Claude 6173e185ec docs(seed): document dual-purpose mother-mcp key for Forgejo + mother MCP
- Update ssh/config example to show mother-mcp key with both Host entries
  (mother MCP and code.smilepowered.org with IdentitiesOnly yes)
- Add dedicated mother-mcp section explaining the key serves two roles:
  1. MCP calls to mother (command=colibri-mcp,restrict)
  2. Git pull from Forgejo as a read-only deploy key
- Note that read-only is sufficient and limits blast radius
- Update START-HERE.txt to mention git pull works OOTB with seeded key
2026-06-23 11:36:10 +02:00

91 lines
2 KiB
Text

CLAWDIE OPERATOR USB — START HERE
=================================
This desktop opens quiet on purpose.
Colibri runs in the background; you choose when to open the operator UI.
FIRST ACTIONS
-------------
1. Save any notes you want in this file or close it.
2. Open "Colibri Dashboard" on the desktop when you are ready.
3. Run 'mdo -u root hw-report' in a terminal if this machine needs diagnostics.
COLIBRI
-------
The daemon should already be running.
Check:
service colibri_daemon status
If needed:
mdo -u root service colibri_daemon start
Desktop launcher:
Colibri Dashboard
Terminal commands:
colibri status
colibri snapshot
colibri list-tasks
colibri list-skills
colibri-mcp tools
SECRETS / PROVIDERS
-------------------
Provider env:
/usr/local/etc/colibri/provider.env
If you are using Vaultwarden bootstrap:
- the image already knows the Clawdie Vaultwarden URL
- add BW_CLIENTID, BW_CLIENTSECRET, and BW_PASSWORD
- keep the file mode 0600
- restart colibri_daemon after edits
Example:
mdo -u root ee /usr/local/etc/colibri/provider.env
mdo -u root chmod 600 /usr/local/etc/colibri/provider.env
mdo -u root service colibri_daemon restart
LIVE SEED
---------
Seed partition label:
CLAWDIESEED
If this stick was seeded with provider keys, there is nothing to do: the
agent's keys were loaded before the daemon started, so Colibri auto-spawns
the agent on boot. Check with:
colibri status
If a mother-mcp key was seeded, git pull from Forgejo works out-of-the-box:
cd ~/ai/clawdie-iso && git pull
cd ~/ai/clawdie-ai && git pull
The key is wired via ~/.ssh/config for both mother MCP and code.smilepowered.org.
Readable operator guide:
/usr/local/share/clawdie-iso/seed/README.txt
REFERENCE
---------
Full HTML reference:
/usr/local/share/clawdie-iso/bootstrap/index.html
Open manually:
firefox file:///usr/local/share/clawdie-iso/bootstrap/index.html
HARDWARE REPORT
---------------
Terminal:
mdo -u root hw-report
PRIVILEGE MODEL
---------------
This USB does not use sudo.
Use:
mdo -u root <command>