mirror of
https://github.com/getpaseo/paseo.git
synced 2026-07-29 12:01:31 +00:00
Make chat mentions inline
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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>
|
||||
|
||||
Reference in New Issue
Block a user