Make chat mentions inline

This commit is contained in:
Mohamed Boudra
2026-03-28 10:51:22 +07:00
parent 05a4e8f5a3
commit 7ca428677c
12 changed files with 123 additions and 45 deletions

View File

@@ -27,10 +27,8 @@ When using chat:
- check chat often while working
Mentions are active:
- use `--mention <agent-id>` on your post to notify a specific agent immediately
- if you use `--reply-to`, the author of the replied-to message is notified
- notifications are sent via `paseo send --no-wait` under the hood
- mentions **interrupt** the target agent, so only mention when they need to act now
- write mentions inline in the message body as `@<agent-id>` to notify a specific agent immediately
- notifications are sent to the target agent without blocking the chat post
- if a normal post is enough and no one needs to act right now, skip the mention
## Command Surface
@@ -68,7 +66,7 @@ paseo chat post issue-456 "I can take that next." --reply-to msg-001
With a direct mention:
```bash
paseo chat post issue-456 "Can you verify the relay path next?" --mention <agent-id>
paseo chat post issue-456 "@<agent-id> Can you verify the relay path next?"
```
### Read recent messages
@@ -101,7 +99,7 @@ When using a room:
- read only a bounded window before acting
- post updates when they would help another agent or your future self
- use `--reply-to` when responding to a specific message
- use `--mention` when you want to get a specific agent's attention — but know that mentions **interrupt** the target agent
- use inline `@<agent-id>` mentions when you want to get a specific agent's attention
- check chat frequently enough that shared coordination actually works
- your own agent ID is available via `$PASEO_AGENT_ID`
@@ -119,4 +117,4 @@ Typical things to post:
3. Read the room with bounded history
4. Post clearly
5. Use `--reply-to` when replying to a specific message
6. Use `--mention` when you want to notify someone directly
6. Use inline `@<agent-id>` mentions when you want to notify someone directly

View File

@@ -97,11 +97,10 @@ paseo chat post <room> "Focus on implementing the API layer. Acceptance criteria
- all new endpoints have tests
- typecheck passes
Post your progress here. @mention me ($PASEO_AGENT_ID) when done." \
--mention <agent-id>
Post your progress here. @$PASEO_AGENT_ID when done, and start on this now @<agent-id>."
```
The agent gets interrupted with the message and starts working. When done, it @mentions you back.
The agent gets notified with the message and starts working. When done, it mentions you back in chat.
### Role-based provider selection
@@ -148,13 +147,13 @@ paseo chat read <room> --limit 10
### Directing work
```bash
paseo chat post <room> "The API is done. Now focus on the frontend integration." --mention <agent-id>
paseo chat post <room> "@<agent-id> The API is done. Now focus on the frontend integration."
```
### Course-correcting
```bash
paseo chat post <room> "The tests you wrote are asserting the mock, not the real implementation. Re-read the acceptance criteria — we need integration tests against a real database." --mention <agent-id>
paseo chat post <room> "@<agent-id> The tests you wrote are asserting the mock, not the real implementation. Re-read the acceptance criteria — we need integration tests against a real database."
```
### Challenging agents

View File

@@ -133,7 +133,7 @@ paseo chat inspect <name-or-id>
# Post a message
paseo chat post <room> "<message>"
paseo chat post <room> "<message>" --reply-to <msg-id>
paseo chat post <room> "<message>" --mention <agent-id> # Repeatable
paseo chat post <room> "@<agent-id> <message>"
# Read messages
paseo chat read <room>