agency-messaging

Discover all agents in the current agency and send/receive async messages between agents and the human owner via the inbox system.

Jump to install

Repository: chenhg5/agencycli
Last source activity: March 21, 2026 at 11:19
Detected SKILL.md language: English
Stars: 149
Forks: 12

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/chenhg5/agencycli --skill agency-messaging

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

agencycli

Manage AI agent teams with agencycli — a CLI tool for organising AI agents (Claude Code, Codex, Gemini, Cursor, etc.) into hierarchical teams (Agency → Team → Role → Project → Agent). Key capabilities: create agencies and teams, hire agents with merged context layers, assign and run tasks with priority queues, manage autonomous playbooks (wakeup.md), send async inbox messages between human and agents, configure heartbeat schedules and cron jobs, run agents inside Docker sandboxes, forward/confirm tasks via inbox, manage templates, and more. Use this skill whenever you need to: create or manage an agencycli workspace, hire/fire/sync agents, add/run/cancel tasks, check inbox confirmations, send messages, configure heartbeats or crons, start the scheduler, or work with agency templates.

2026-07-10

agencycli-usage

Operate the agencycli tool — create agencies, teams, projects, and hire AI agents into working directories.

2026-07-09

task-management

Create, assign, monitor, and close tasks across agents. Covers full task lifecycle — add, priority, dependencies, confirm-request, retry, cancel, bulk ops, and cross-agent search.

2026-07-09

View all from this repository

name	agency-messaging
description	Discover all agents in the current agency and send/receive async messages between agents and the human owner via the inbox system.

Skill: Agency Messaging

You can discover every agent in this agency and exchange async messages with them or with the human owner. Messages are non-blocking: the sender continues working immediately, and the recipient reads the message on their next wakeup.

The agency workspace is at: $AGENCY_DIR

Discover Agents

agencycli --dir $AGENCY_DIR list agents
agencycli --dir $AGENCY_DIR show agent <project> <agent>

Recipient address format

Human owner: human
Any agent: <project>/<agent> — e.g. cc-connect/pm, cc-connect/qa-reviewer

Send a Message

# Single recipient
agencycli --dir $AGENCY_DIR inbox send \
  --from <your-address> \
  --to   <recipient-address> \
  --subject "<subject>" \
  --body "<body>"

# Group send — repeat --to for multiple recipients
agencycli --dir $AGENCY_DIR inbox send \
  --from cc-connect/pm \
  --to cc-connect/dev-claude --to cc-connect/qa-reviewer --to human \
  --subject "Sprint kick-off" \
  --body "New sprint starts Monday. See backlog for tasks."

Examples:

# PM → dev-claude: extra context
agencycli --dir $AGENCY_DIR inbox send \
  --from cc-connect/pm --to cc-connect/dev-claude \
  --subject "Issue #205 extra context" \
  --body "Only reproduces with UTF-8 filenames. Reproduce: echo '测试' > test.txt"

# PM → human: async progress update
agencycli --dir $AGENCY_DIR inbox send \
  --from cc-connect/pm --to human \
  --subject "Backlog updated" \
  --body "Added 3 new issues (P2). No action needed, just FYI."

# PM → QA: heads-up
agencycli --dir $AGENCY_DIR inbox send \
  --from cc-connect/pm --to cc-connect/qa-reviewer \
  --subject "PR incoming for #205" \
  --body "dev-claude is working on it. Expect a PR within the hour."

Reply to a Message

agencycli --dir $AGENCY_DIR inbox reply <msg-id> \
  --from <your-address> \
  --body "<reply text>"

Forward a Message

# Forward to a single recipient
agencycli --dir $AGENCY_DIR inbox fwd <msg-id> \
  --from <your-address> \
  --to   <recipient-address>

# Forward to multiple recipients with a note
agencycli --dir $AGENCY_DIR inbox fwd <msg-id> \
  --from cc-connect/pm \
  --to cc-connect/dev-claude --to cc-connect/qa-reviewer \
  --note "Please coordinate on this."

The forwarded message includes the original sender, subject, and body. Subject is auto-prefixed with Fwd:.

Read Messages

# Your unread messages (also auto-injected into your wakeup prompt)
agencycli --dir $AGENCY_DIR inbox messages --recipient <your-address>

# Filter by sender
agencycli --dir $AGENCY_DIR inbox messages --recipient <your-address> --from human

# All messages including already-read
agencycli --dir $AGENCY_DIR inbox messages --recipient <your-address> --all

# Show archived messages
agencycli --dir $AGENCY_DIR inbox messages --recipient <your-address> --archived

# Mark all as read after listing
agencycli --dir $AGENCY_DIR inbox messages --recipient <your-address> --mark-read

Per-Message Status Management

# Mark a single message as read
agencycli --dir $AGENCY_DIR inbox read <msg-id> --recipient <your-address>

# Archive (hides from normal listing, retrievable with --archived)
agencycli --dir $AGENCY_DIR inbox archive <msg-id> --recipient <your-address>

# Permanently delete
agencycli --dir $AGENCY_DIR inbox delete <msg-id> --recipient <your-address>
agencycli --dir $AGENCY_DIR inbox rm     <msg-id> --recipient <your-address>

When to Use Messaging vs. Confirm-Request

Situation	Use
Need human to make a decision before you continue	`task confirm-request` (non-blocking, archived)
Sending info or a heads-up, no reply needed immediately	`inbox send` (non-blocking)
Coordinating context between agents asynchronously	`inbox send` (non-blocking)
Broadcast to multiple participants at once	`inbox send --to A --to B --to C`
Forwarding a message to someone else	`inbox fwd`
Replying to a message someone sent you	`inbox reply`

Common PM Messaging Patterns

# 1. Broadcast sprint kick-off to all agents
agencycli --dir $AGENCY_DIR inbox send \
  --from cc-connect/pm \
  --to cc-connect/dev-claude --to cc-connect/qa-reviewer --to cc-connect/biz-dev \
  --subject "Sprint W14 kick-off" \
  --body "Focus this week: <priorities>. See backlog for assigned tasks."

# 2. Notify dev of approved task
agencycli --dir $AGENCY_DIR inbox send \
  --from cc-connect/pm --to cc-connect/dev-claude \
  --subject "New task approved: <task-title>" \
  --body "Human confirmed. Priority: P<N>. Key context: <notes>"

# 3. Escalate stale task to human
agencycli --dir $AGENCY_DIR inbox send \
  --from cc-connect/pm --to human \
  --subject "Task stale: <task-title>" \
  --body "Task <id> has been in_progress for >2 days. May need intervention."

# 4. Forward a customer report from human to dev
agencycli --dir $AGENCY_DIR inbox fwd <msg-id> \
  --from cc-connect/pm --to cc-connect/dev-claude \
  --note "Customer reported this bug. Please investigate."

agency-messaging

Source facts

Install options

Review the source files

More from this repository

Skill: Agency Messaging

Discover Agents

Recipient address format

Send a Message

Reply to a Message

Forward a Message

Read Messages

Per-Message Status Management

When to Use Messaging vs. Confirm-Request

Common PM Messaging Patterns

More from this repository

Skill: Agency Messaging

Discover Agents

Recipient address format

Send a Message

Reply to a Message

Forward a Message

Read Messages

Per-Message Status Management

When to Use Messaging vs. Confirm-Request

Common PM Messaging Patterns