# hiboss

> AI Agent ↔ Boss communication tool

Let AI agents send messages to their human boss and receive replies through Discord and Telegram. Agents call hiboss send or hiboss ask — the message lands in your chat app, and your reply flows back to the agent. Agents can also boss other agents for autonomous multi-agent workflows.

## Features

- Agent-to-boss messaging via Discord & Telegram
- Blocking ask with quick-reply buttons
- Action buttons that trigger shell commands
- Priority-based channel routing
- Agent-as-boss for multi-agent orchestration
- Cross-session agent-to-agent messaging
- Session auto-discovery and peer listing
- MCP server for AI coding tools
- File attachments via R2 storage
- Self-hosted on Cloudflare Workers + D1

## Architecture

```
                         +---------------------+
  hiboss CLI (Rust)      |  hiboss-server      |     Discord / Telegram
  hiboss MCP Server  <-->|  (Cloudflare Worker) |<--->  Boss (human or AI)
                         |  D1 + R2 storage    |
                         +---------------------+
```

The server runs on Cloudflare Workers with D1 for persistence and R2 for file
attachments. Channels are pluggable adapters — configure one or more, and messages
route through whichever you choose.

## CLI Commands

### Messaging
- `hiboss send "message"` — async message to boss
- `hiboss send --priority high "message"` — urgent message
- `hiboss ask "question" --timeout 60` — blocking, wait for reply
- `hiboss ask --options "A,B,C" "Pick one"` — quick-reply buttons
- `hiboss ask --actions "Approve:make deploy,Reject" "Deploy?"` — action buttons
- `hiboss send --file ./screenshot.png "See attached"` — file attachment

### Inbox & Replies
- `hiboss inbox` — unread messages from boss
- `hiboss read <id>` — message with reply chain
- `hiboss reply <id> "Done"` — reply to boss
- `hiboss react <id> "emoji"` — emoji reaction

### Agent-to-Agent
- `hiboss send --to <session> "message"` — message a peer agent
- `hiboss boss add "Orchestrator" --agent-id <id>` — agent as boss
- `hiboss group broadcast <group-id> "message"` — broadcast to group

## Install

```
curl -fsSL hiboss.agent-tools.org/install.sh | sh
# or: cargo install hiboss
hiboss init https://your-server.workers.dev
hiboss channel set telegram --bot-token <TOKEN> --chat-id <ID>
```

## Links

- Homepage: https://hiboss.agent-tools.org
- Repo: https://github.com/sunoj/hiboss
- License: MIT
- Parent: https://agent-tools.org