diff --git a/README.md b/README.md
index c20bec1..2b99161 100644
--- a/README.md
+++ b/README.md
@@ -48,7 +48,7 @@ ollie/
       fifo.out          read:  pop the next queued prompt
       models            read:  available models from the backend
       offset            read:  byte offset in chat immediately after the last user prompt
-      peer/             dir:   peer session references
+      peer/             dir:   peer links (touch to add, rm to remove — both sides; write to send prompt)
       plan              r/w:   scratch space for agent planning (persisted per session)
       proc/             dir:   detached background processes
       prompt            write: submit a prompt to the agent
diff --git a/prompts/session_9p.md b/prompts/session_9p.md
index 2507da8..1d1dcd7 100644
--- a/prompts/session_9p.md
+++ b/prompts/session_9p.md
@@ -82,7 +82,7 @@ Sessions live at `${OLLIE}/s/`. Each session is a directory; all operations are
 | `fifo.out`    | read  | Pop queued prompt (FIFO output) |
 | `models`      | read  | Available models for current backend |
 | `offset`      | read  | Byte offset after last user prompt |
-| `peer/`       | dir   | Peer session references |
+| `peer/`       | dir   | Peer links. `touch` to add, `rm` to remove (both sides updated). Write to send prompt to peer. |
 | `plan`        | r/w   | Session-scoped markdown checklist; survives compaction; visible to peers |
 | `proc/`       | dir   | Detached background processes |
 | `prompt`      | write | Submit a prompt to the agent |
@@ -143,4 +143,13 @@ cat $OLLIE/s/{id}/state
 
 # Discover available models
 cat $OLLIE/s/{id}/models
+
+# Add a peer link (bidirectional)
+touch $OLLIE/s/{id}/peer/{peerid}
+
+# Send a prompt to a peer
+echo "your message" > $OLLIE/s/{id}/peer/{peerid}
+
+# Remove a peer link (bidirectional)
+rm $OLLIE/s/{id}/peer/{peerid}
 ```
diff --git a/prompts/session_dbus.md b/prompts/session_dbus.md
index 4fa53d7..8d7591b 100644
--- a/prompts/session_dbus.md
+++ b/prompts/session_dbus.md
@@ -71,8 +71,8 @@ All session operations go through the D-Bus interface.
 
 | Method | Args | Returns | Purpose |
 |---|---|---|---|
-| `PeerAdd` | session_id, peer_id | bool | Add peer relationship |
-| `PeerRemove` | session_id, peer_id | bool | Remove peer relationship |
+| `PeerAdd` | session_id, peer_id | bool | Add bidirectional peer link (both sides updated) |
+| `PeerRemove` | session_id, peer_id | bool | Remove bidirectional peer link (both sides updated) |
 | `PeerList` | session_id | array of peer_ids | List peers |
 | `PeerSubmit` | session_id, peer_id, prompt | bool | Send prompt to peer |