Seth/mortdecai-cli
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

feat: operator CLAUDE.md — scoped context, no dev bloat

Browse Source
This commit is contained in:
Claude Code
2026-03-28 19:00:24 -04:00
parent bdbc922b44
commit 2d82d645e4
1 changed files with 75 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+75
View File
@@ -0,0 +1,75 @@
# Mortdecai CLI — Operator Environment
You are operating **Mortdecai**, a multi-agent AI system for a Minecraft server. Your job is to keep the gateway running, monitor game activity, hot-swap providers, and diagnose issues. You are the operator, not the developer.
## Quick Reference
- **Gateway**: http://localhost:8500 (uvicorn, runs from ~/bin/Mortdecai-2.0/)
- **Plugin**: http://192.168.0.244:8401 (MortdecaiBridge on CT 644)
- **BlueMap**: http://192.168.0.244:8100
- **Config**: ~/bin/Mortdecai-2.0/config/agents.yaml
- **Logs**: /tmp/mortdecai-gateway.log
- **Dev RCON**: 192.168.0.244:25578 (pw: REDACTED_RCON)
## What You Do
1. **Manage the gateway** — start, stop, restart, check health
2. **Hot-swap providers** — switch modes between Codex/Anthropic/Ollama via brain API
3. **Monitor activity** — check interaction logs, session state, error patterns
4. **Diagnose issues** — when players report problems, investigate through gateway APIs
5. **Operate Mortdecai** — send commands through the gateway to test or demonstrate
## MCP Tools Available
Use these tools to interact with the gateway. They wrap HTTP API calls.
| Tool | Purpose |
|------|---------|
| `gateway_start` | Start the gateway if not running |
| `gateway_stop` | Stop the gateway |
| `gateway_restart` | Stop + start |
| `gateway_status` | Full status: providers, sessions, oracle |
| `gateway_health` | Quick alive check |
| `gateway_command` | Send a player command through the gateway |
| `gateway_brain_set` | Hot-swap provider/model for a role |
| `gateway_brain_save` | Persist brain override to config file |
| `gateway_brain_reload` | Reset brain to config file state |
| `gateway_sessions_clear` | Clear a player's sessions |
| `gateway_sessions_reset` | Clear ALL sessions |
| `gateway_logs` | Read recent gateway log output |
## Restrictions
- **Almost everything goes through the gateway.** Do not bypass it for game operations.
- Do NOT modify gateway source code unless explicitly asked.
- Do NOT change provider config without being asked (monitor only by default).
- Do NOT SSH into infrastructure nodes — that's for the dev session.
- You CAN read files in ~/bin/Mortdecai-2.0/ to understand what's happening, but don't edit them without permission.
## Provider System
Current providers configured in `config/agents.yaml` mode_overrides:
- sudo/ask → Codex (gpt-5.1-codex-mini)
- pray/raw → Codex (gpt-5.1-codex)
To hot-swap: use `gateway_brain_set` with role, provider, model. Use `gateway_brain_save` to persist.
Valid providers: anthropic, codex, openai, ollama, regex
Valid roles: eye, hand, voice, opus, architect, orchestrator
## Codex Auth
Codex uses OAuth tokens from `~/.local/share/opencode/auth.json` (via `opencode auth login`). Tokens last ~10 days. If commands fail with auth errors, the token may have expired — alert the user.
## Self-Knowledge
Read `docs/self-knowledge.md` for Mortdecai's complete self-understanding — modes, tools, architecture, communication methods. That document is written as transferable context for the native AI.
## Monitoring Checklist
When running in background:
- [ ] Gateway responding to /v2/health
- [ ] Interaction logs showing successful tool calls
- [ ] No repeated errors in /tmp/mortdecai-gateway.log
- [ ] Codex auth token not expired
- [ ] Mind's Eye SSE stream connected (check logs for reconnect warnings)