Installation

# Install the MCP server binary
cargo install agentic-comm-mcp

# Install the CLI for direct interaction
cargo install agentic-comm-cli

{
  "mcpServers": {
    "agentic-comm": {
      "command": "agentic-comm-mcp",
      "args": []
    }
  }
}

cargo install agentic-comm-cli

cargo install agentic-comm-mcp --features rest,webhook

# Run with REST API enabled
agentic-comm-mcp serve --rest-port 9090 --webhook-port 8080

git clone https://github.com/agentralabs/agentic-comm
cd agentic-comm

# Build all binaries
cargo build --release

# Install locally
cargo install --path crates/agentic-comm-cli
cargo install --path crates/agentic-comm-mcp

# ~/.config/agentic-comm/config.toml

[store]
default_path = "~/Documents/agentic/comm.acomm"
flush_mode = "batch"
batch_size = 100
batch_delay_ms = 5000

[defaults]
sender = "claude-code"
channel = "main"

[logging]
level = "info"
# file = "/var/log/agentic-comm.log"  # Optional log file

[identity]
# name = "default"  # AgenticIdentity name for message signing

[limits]
max_message_size = 1048576
max_channels = 100000
max_messages = 10000000

Usage: acomm <COMMAND> [OPTIONS] [STORE_PATH]

Commands:
  init         Create a new .acomm store
  send         Send a message
  receive      Receive messages
  ack          Acknowledge a command message
  publish      Publish to a pub/sub topic
  broadcast    Broadcast to all channel participants
  search       Search messages by content
  history      Query communication history
  thread       View a message thread by correlation ID
  stats        Show store statistics
  compact      Remove old archived messages and dead letters
  channel      Channel management subcommands
  subscribe    Subscribe to a pub/sub topic
  unsubscribe  Remove a subscription
  export       Export messages to JSON
  import       Import messages from JSON
  completions  Generate shell completions

Options:
  -v, --verbose    Enable verbose output
  --log-level      Set log level (trace, debug, info, warn, error)
  -h, --help       Print help
  -V, --version    Print version

Usage: acomm init [STORE_PATH]

Arguments:
  [STORE_PATH]  Path for the new store file [default: ./comm.acomm]

Options:
  --force  Overwrite if file exists

Usage: acomm send [OPTIONS] <CONTENT> [STORE_PATH]

Arguments:
  <CONTENT>     Message content (use - to read from stdin)
  [STORE_PATH]  Path to the .acomm store [default: $ACOMM_STORE]

Options:
  --channel <NAME>       Channel name [default: $ACOMM_DEFAULT_CHANNEL]
  --sender <ID>          Sender participant ID [default: $ACOMM_SENDER]
  --type <TYPE>          Message type: text, command, query, broadcast, notification [default: text]
  --topic <TOPIC>        Topic string (for pub/sub channels)
  --priority <LEVEL>     Priority: critical, high, normal, low, background [default: normal]
  --ttl <SECONDS>        Time-to-live in seconds
  --correlation <ID>     Correlation ID for threading
  --metadata <JSON>      JSON metadata object

Usage: acomm receive [OPTIONS] [STORE_PATH]

Options:
  --channel <NAME>   Channel name [default: $ACOMM_DEFAULT_CHANNEL]
  --as <ID>          Receive as this participant [default: $ACOMM_SENDER]
  --type <TYPE>      Filter by message type (comma-separated)
  --after <TIME>     Messages after this timestamp (ISO 8601 or Unix seconds)
  --before <TIME>    Messages before this timestamp
  --limit <N>        Maximum messages to return [default: 100]
  --offset <N>       Skip first N messages [default: 0]
  --format <FMT>     Output format: table, json, csv [default: table]
  --unread           Only show unread messages

Usage: acomm ack [OPTIONS] [CONTENT] [STORE_PATH]

Options:
  --message-id <ID>  ID of the message to acknowledge [required]
  --sender <ID>      Acknowledging participant [default: $ACOMM_SENDER]
  --status <STATUS>  Ack status: received, in_progress, completed, failed [required]

Usage: acomm publish [OPTIONS] <CONTENT> [STORE_PATH]

Options:
  --channel <NAME>   PubSub channel name [required]
  --sender <ID>      Publisher participant ID [default: $ACOMM_SENDER]
  --topic <TOPIC>    Topic string [required]
  --priority <LEVEL> Priority [default: normal]

Usage: acomm broadcast [OPTIONS] <CONTENT> [STORE_PATH]

Options:
  --channel <NAME>  Channel name [required]
  --sender <ID>     Sender (must be channel owner for broadcast channels) [default: $ACOMM_SENDER]

Usage: acomm search [OPTIONS] <QUERY> [STORE_PATH]

Arguments:
  <QUERY>  Search string (prefix with "regex:" for regex matching)

Options:
  --channel <NAME>   Limit search to a specific channel
  --sender <ID>      Limit search to messages from this sender
  --type <TYPE>      Limit search to this message type
  --limit <N>        Maximum results [default: 50]
  --format <FMT>     Output format: table, json, csv [default: table]

Usage: acomm history [OPTIONS] [STORE_PATH]

Options:
  --channel <NAME>   Filter by channel
  --sender <ID>      Filter by sender
  --type <TYPE>      Filter by message type
  --after <TIME>     After timestamp
  --before <TIME>    Before timestamp
  --status <STATUS>  Filter by status
  --limit <N>        Maximum results [default: 100]
  --offset <N>       Pagination offset [default: 0]
  --format <FMT>     Output format: table, json, csv [default: table]
  --include-archived Include archived messages

Usage: acomm thread <CORRELATION_ID> [STORE_PATH]

Usage: acomm stats [STORE_PATH]

Usage: acomm compact [OPTIONS] [STORE_PATH]

Options:
  --older-than <DURATION>  Remove items older than this (e.g., "7d", "30d", "1y")
  --dry-run                Show what would be removed without removing

Usage: acomm channel <SUBCOMMAND> [STORE_PATH]

Subcommands:
  create   Create a new channel
  list     List all channels
  info     Show channel details
  join     Add a participant
  leave    Remove a participant
  config   Update channel configuration
  pause    Pause message delivery on a channel
  resume   Resume a paused channel
  drain    Stop accepting new messages, deliver pending
  close    Close a channel
  delete   Delete a channel and its messages

Usage: acomm channel create [OPTIONS] [STORE_PATH]

Options:
  --name <NAME>     Channel name [required]
  --type <TYPE>     Channel type: direct, group, broadcast, pubsub [required]
  --owner <ID>      Owner participant ID [required]
  --description <TEXT>  Channel description
  --tags <TAGS>     Comma-separated tags

Usage: acomm subscribe [OPTIONS] [STORE_PATH]

Options:
  --channel <NAME>      PubSub channel name [required]
  --subscriber <ID>     Subscriber participant ID [required]
  --topic <PATTERN>     Topic pattern (supports *, #) [required]

Usage: acomm export [OPTIONS] [STORE_PATH]

Options:
  --output <PATH>    Output file (default: stdout)
  --channel <NAME>   Export only this channel
  --format <FMT>     Export format: json, csv [default: json]

Usage: acomm import [OPTIONS] <INPUT_PATH> [STORE_PATH]

Options:
  --format <FMT>     Input format: json, csv [default: json]
  --channel <NAME>   Import into this channel (create if needed)

Usage: acomm completions <SHELL>

Arguments:
  <SHELL>  Shell: bash, zsh, fish, powershell

# Bash
acomm completions bash > ~/.local/share/bash-completion/completions/acomm

# Zsh
acomm completions zsh > ~/.zfunc/_acomm

# Fish
acomm completions fish > ~/.config/fish/completions/acomm.fish

Usage: agentic-comm-mcp serve [OPTIONS]

Options:
  --store <PATH>        Store file path [default: $ACOMM_STORE]
  --log-level <LEVEL>   Log level [default: warn]
  --rest-port <PORT>    Enable REST bridge on this port
  --webhook-port <PORT> Enable webhook receiver on this port
  --mode <MODE>         Session mode: full, minimal [default: full]

Usage: agentic-comm-mcp info [STORE_PATH]

Usage: agentic-comm-mcp validate <STORE_PATH>

Usage: agentic-comm-mcp export [OPTIONS] [STORE_PATH]

Usage: agentic-comm-mcp compact [OPTIONS] [STORE_PATH]

Usage: agentic-comm-mcp stats [STORE_PATH]

cargo install agentic-comm-cli --force
cargo install agentic-comm-mcp --force

acomm init /tmp/test.acomm
acomm channel create --name test --type group --owner test-agent /tmp/test.acomm
acomm send --channel test --sender test-agent "Hello, AgenticComm" /tmp/test.acomm
acomm stats /tmp/test.acomm
rm /tmp/test.acomm

Store: /tmp/test.acomm
Channels:      1
Messages:      1
Subscriptions: 0
Dead Letters:  0

npm install @agenticamem/comm

curl -fsSL https://agentralabs.tech/install/comm | bash