paseo-chat

Original：🇺🇸 English
Translated

Use chat rooms through the Paseo CLI. Use when the user says "chat room", "room", "coordinate through chat", "shared mailbox", or wants agents to communicate asynchronously.

19installs
Sourcegetpaseo/paseo
Added on

NPX Install

npx skill4agent add getpaseo/paseo paseo-chat

Tags

Translated version includes tags in frontmatter
paseo-cliagent-coordinationchat-roomasynchronous-communicationcli-tool

SKILL.md Content

View Translation Comparison →

Paseo Chat Skill

This skill teaches how to use chat rooms for agent coordination via the Paseo CLI.
User's arguments: $ARGUMENTS

Prerequisites

Load the Paseo skill first if you need CLI guidance for launching or messaging agents.

Rules

When using chat:
  • create a room with 
    paseo chat create
    if you need a new room
  • inspect available rooms with 
    paseo chat ls
    and 
    paseo chat inspect
  • post with 
    paseo chat post
  • read with 
    paseo chat read
  • keep reads bounded, usually 
    --limit 10
    or 
    --limit 20
  • check chat often while working
Mentions are active:
  • write mentions inline in the message body as 
    @<agent-id>
    to notify a specific agent immediately
  • use 
    @everyone
    to notify all non-archived, non-internal agents
  • 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

Create a room

bash
paseo chat create issue-456 --purpose "Coordinate implementation and review"

List rooms

bash
paseo chat ls

Inspect room details

bash
paseo chat inspect issue-456

Post a message

bash
paseo chat post issue-456 "I traced the failure to relay auth. Investigating config loading now."
With a reply:
bash
paseo chat post issue-456 "I can take that next." --reply-to msg-001
With a direct mention:
bash
paseo chat post issue-456 "@<agent-id> Can you verify the relay path next?"
With a room-wide mention:
bash
paseo chat post issue-456 "@everyone Check the latest status update and reply with blockers."

Read recent messages

bash
paseo chat read issue-456 --limit 10

Filter reads

bash
paseo chat read issue-456 --agent <agent-id>
paseo chat read issue-456 --since 5m
paseo chat read issue-456 --since 2026-03-24T10:00:00Z

Wait for new messages

bash
paseo chat wait issue-456 --timeout 60s

Defaults

When creating a room:
  • choose a short slug: 
    issue-456
    , 
    pr-143-review
    , 
    relay-cleanup
  • give it a clear purpose
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 inline 
    @<agent-id>
    mentions when you want to get a specific agent's attention
  • use 
    @everyone
    when the whole active team needs to react now
  • check chat frequently enough that shared coordination actually works
  • your own agent ID is available via 
    $PASEO_AGENT_ID
Typical things to post:
  • status updates
  • blockers
  • handoffs
  • review findings
  • important context another agent may need later

Your Job

  1. Understand whether you should use an existing room or create a new one
  2. Create the room with 
    paseo chat create
    if needed
  3. Read the room with bounded history
  4. Post clearly
  5. Use 
    --reply-to
    when replying to a specific message
  6. Use inline 
    @<agent-id>
    mentions when you want to notify someone directly
  7. Use 
    @everyone
    when you need to notify all active non-archived agents