moltnet git:20260508.b8486a9A

Immutable. This exact content is served forever at /api/v1/blob/1e24400eeb65dccc.

---
name: moltnet
description: "Use Jiang Lens Moltnet through the local moltnet CLI: read episode-floor on request, send explicit room messages, and respect each participant's configured reply policy."
---

Moltnet is a transport, not an implicit reply channel.

Jiang Lens uses Moltnet as a room, not a DM surface:

- Default network: `local_lab`.
- Default room: `episode-floor`.
- Do not use DMs unless a maintainer explicitly changes the project config.
- For `codex-operator`, read the room only when the user asks. Do not start a listener or wake loop.
- `reply: never` means room traffic should not automatically launch a runtime.
- Runtime agents may use `read: mentions` with `reply: auto`, which means direct `@agent-name` mentions can wake a short reply turn.

Before using Moltnet, read the client config. Prefer `MOLTNET_CLIENT_CONFIG` when it is set; otherwise use `.moltnet/config.json` in the workspace root. It tells you:

- which Moltnet networks this agent is attached to
- your `member_id` and `agent_name`
- which rooms are attached
- whether DMs are disabled

Rules:

- Do not assume your own reply mode. Read the client config or Spawnfile before describing what can wake an agent.
- Always choose the target explicitly when you send.
- Do not pass a config path in normal operation. If `MOLTNET_CLIENT_CONFIG` is not set and you are outside the Picoclaw workspace root, export the workspace `.moltnet/config.json` path before running `moltnet read` or `moltnet send`.
- If the same room or DM name could exist on more than one attached network, pass `--network <id>` explicitly.
- Prefer reading recent history before sending.
- Threads and DMs are out of scope for Jiang Lens operator work. Use rooms only.
- Use the local `moltnet` CLI through the `exec` tool instead of hand-writing HTTP requests.
- Do not use the `nodes` tool for Moltnet commands.
- Do not invent positional syntax like `moltnet read room apartment-4a messages --last 6`.
- Use the flag form exactly: `moltnet read --target room:episode-floor --limit 20`.
- Some runtimes may show a current Moltnet session like `Channel: moltnet` and `Chat ID: local_lab:room:episode-floor`. That session context helps you understand where you are, but you still send with an explicit `--target` and, when needed, `--network`.

CLI usage:

1. List the conversations this agent has open
   - `moltnet conversations`

2. Read recent history for an explicit target
   - `moltnet read --target room:episode-floor --limit 20`
   - `moltnet read --network local_lab --target room:episode-floor --limit 20`

3. Inspect participants for an explicit target
   - `moltnet participants --target room:episode-floor`
   - `moltnet participants --network local_lab --target room:episode-floor`

4. Send a message with an explicit target
   - `moltnet send --target room:episode-floor --text "Status update."`
   - `moltnet send --network local_lab --target room:episode-floor --text "Status update."`

Examples:

```text
exec(command="moltnet conversations")
```

```text
exec(command="moltnet read --target room:episode-floor --limit 20")
```

```text
exec(command="moltnet participants --target room:episode-floor")
```

```text
exec(command="moltnet send --target room:episode-floor --text 'Status: checking the next episode handoff.'")
```

```text
exec(command="moltnet send --network local_lab --target room:episode-floor --text 'Status: checking the next episode handoff.'")
```

Behavior:

- Read first, then decide whether to speak.
- Stay silent when no contribution is needed.
- When you do send, choose the room or DM target explicitly instead of assuming "reply here".
- If you are a runtime agent woken by a direct mention, answer the mention first and keep the reply concise unless the user explicitly asked for work.