agent-messenger 1.15.0 → 2.0.0

package/README.md

@@ -1,12 +1,14 @@
+<div align="center">
+
 # Agent Messenger
 
-[![npm version](https://img.shields.io/npm/v/agent-messenger)](https://www.npmjs.com/package/agent-messenger) [![SkillPad - agent-slack](https://img.shields.io/badge/SkillPad-agent--slack-1a1a1a)](https://skillpad.dev/install/devxoul/agent-messenger/agent-slack) [![SkillPad - agent-slackbot](https://img.shields.io/badge/SkillPad-agent--slackbot-1a1a1a)](https://skillpad.dev/install/devxoul/agent-messenger/agent-slackbot) [![SkillPad - agent-discord](https://img.shields.io/badge/SkillPad-agent--discord-1a1a1a)](https://skillpad.dev/install/devxoul/agent-messenger/agent-discord) [![SkillPad - agent-discordbot](https://img.shields.io/badge/SkillPad-agent--discordbot-1a1a1a)](https://skillpad.dev/install/devxoul/agent-messenger/agent-discordbot) [![SkillPad - agent-teams](https://img.shields.io/badge/SkillPad-agent--teams-1a1a1a)](https://skillpad.dev/install/devxoul/agent-messenger/agent-teams) [![SkillPad - agent-channeltalk](https://img.shields.io/badge/SkillPad-agent--channeltalk-1a1a1a)](https://skillpad.dev/install/devxoul/agent-messenger/agent-channeltalk) [![SkillPad - agent-channeltalkbot](https://img.shields.io/badge/SkillPad-agent--channeltalkbot-1a1a1a)](https://skillpad.dev/install/devxoul/agent-messenger/agent-channeltalkbot)
+[![npm](https://img.shields.io/npm/v/agent-messenger?color=E67E22)](https://www.npmjs.com/package/agent-messenger) [![platform](https://img.shields.io/badge/platform-slack-4A154B)](https://agent-messenger.dev/docs/cli/slack) [![platform](https://img.shields.io/badge/platform-discord-5865F2)](https://agent-messenger.dev/docs/cli/discord) [![platform](https://img.shields.io/badge/platform-teams-6264A7)](https://agent-messenger.dev/docs/cli/teams) [![platform](https://img.shields.io/badge/platform-telegram-2AABEE)](https://agent-messenger.dev/docs/cli/telegram) [![platform](https://img.shields.io/badge/platform-whatsapp-25D366)](https://agent-messenger.dev/docs/cli/whatsapp) [![platform](https://img.shields.io/badge/platform-line-06C755)](https://agent-messenger.dev/docs/cli/line) [![platform](https://img.shields.io/badge/platform-instagram-E4405F)](https://agent-messenger.dev/docs/cli/instagram) [![platform](https://img.shields.io/badge/platform-kakaotalk-FEE500)](https://agent-messenger.dev/docs/cli/kakaotalk) [![platform](https://img.shields.io/badge/platform-channel_talk-3B3FE4)](https://agent-messenger.dev/docs/cli/channeltalk)
 
-![Agent Messenger](./docs/public/cover.png)
+**Your agent messages as you — not as a bot**
 
-**Give your AI agent the power to read and send messages across Slack, Discord, Teams, Channel Talk (beta) and more**
+</div>
 
-A unified, agent-friendly CLI for messaging platforms. Zero-config credential extraction from your desktop apps—no OAuth flows, no API keys, no admin approval needed. Works out of the box.
+One CLI for Slack, Discord, Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, and Channel Talk. Credentials extracted from desktop apps or authenticated in seconds — no API keys, no OAuth, no admin approval. TypeScript SDK included.
 
 ## Table of Contents
 
@@ -18,6 +20,8 @@ A unified, agent-friendly CLI for messaging platforms. Zero-config credential ex
   - [Claude Code Plugin](#claude-code-plugin)
   - [OpenCode Plugin](#opencode-plugin)
 - [Quick Start](#quick-start)
+- [SDK](#sdk)
+- [TUI (Experimental)](#tui-experimental)
 - [Supported Platforms](#supported-platforms)
 - [Platform Guides](#platform-guides)
 - [Use Cases](#use-cases)
@@ -32,24 +36,35 @@ A unified, agent-friendly CLI for messaging platforms. Zero-config credential ex
 
 ## Why Agent Messenger?
 
-Messaging platforms only offer Bot tokens for API access—your AI agent can never act **as you**. Agent Messenger extracts user credentials directly from your installed desktop apps, letting your agent operate on your behalf. Bot tokens are fully supported too for server-side and CI/CD use cases.
+**You shouldn't need a bot token to send a message.**
+
+Every platform gates API access behind OAuth apps that need admin approval — days of waiting just to send a message. And even then, your agent is a **bot**, not you. Different name, different permissions, different context.
 
-- **Act as yourself, not a bot** — Extracted user tokens let your agent operate on your behalf
-- **No API keys needed** — Automatically extracts credentials from your installed desktop apps
-- **Zero setup** — Credentials are auto-extracted on first command. No manual auth step required
-- **One interface, multiple platforms** — Learn once, use everywhere (Slack, Discord, Teams, Channel Talk)
-- **AI-agent friendly** — JSON output by default, perfect for LLM tool use
-- **Agent memory** — Remembers workspace IDs, channel names, and preferences across sessions
-- **Human friendly too** — Add `--pretty` for readable output
-- **Token efficient** — CLI, not MCP. Load only what you need. ([Why not MCP?](#philosophy))
+Agent Messenger reads session tokens from your Slack, Discord, Teams, KakaoTalk, or Channel Talk desktop app — zero config. Telegram and WhatsApp authenticate with a one-time phone or pairing code. Either way, your agent operates **as you** — same name, same permissions, same context. Bot tokens are fully supported too for server-side and CI/CD use cases.
+
+- **Auto-Extract Auth** — Reads tokens from Slack, Discord, Teams, KakaoTalk, and Channel Talk desktop apps. Telegram and WhatsApp authenticate with a one-time code — still under a minute
+- **Act As Yourself** — Extracts your user session — not a bot token. Your agent sends messages, reacts, and searches as you. Need bot mode? Bot CLIs are included too
+- **One Interface** — Consistent command style across 7 platforms for supported actions (e.g. message send, message search, channel list, snapshot). Learn once
+- **Agent-Native Output** — JSON by default for LLM tool use. `--pretty` for human-readable. Structured output your agent can parse and act on
+- **Token Efficient** — CLI, not MCP. One skill file, one shell command per action. No server to run, no tool registration. ([Why not MCP?](#philosophy))
+- **Persistent Memory** — Stores workspace IDs, channel mappings, and preferences in ~/.config so your agent never asks twice
+- **TypeScript SDK** — Import clients directly into your app. Full type safety with Zod schemas
 
 ## Installation
 
+**CLI** (global install for terminal / AI agent use):
+
 ```bash
 npm install -g agent-messenger
 ```
 
-Or use your favorite package manager.
+**SDK** (project dependency for programmatic use):
+
+```bash
+npm install agent-messenger
+```
+
+The global install gives you all platform CLIs. The project install gives you both CLIs and the TypeScript SDK.
 
 This installs:
 
@@ -58,26 +73,24 @@ This installs:
 - `agent-discord` — Discord CLI
 - `agent-discordbot` — Discord Bot CLI (bot token, for server-side/CI/CD)
 - `agent-teams` — Microsoft Teams CLI
+- `agent-telegram` — Telegram CLI (user account via TDLib)
+- `agent-whatsapp` — WhatsApp CLI (user account via Baileys, pairing code auth)
+- `agent-whatsappbot` — WhatsApp Bot CLI (Cloud API, for server-side/CI/CD)
+- `agent-line` — LINE CLI (QR code login, Thrift protocol)
+- `agent-instagram` — Instagram DM CLI (user account via private mobile API)
+- `agent-kakaotalk` — KakaoTalk CLI (sub-device login, LOCO protocol)
 - `agent-channeltalk` — Channel Talk CLI (beta, zero-config, extracted cookies)
 - `agent-channeltalkbot` — Channel Talk Bot CLI (beta, API credentials, for server-side/CI/CD)
 
 ## Agent Skills
 
-Agent Messenger includes [Agent Skills](https://agentskills.io/) that teach your AI agent how to use these CLIs effectively. Seven skills are available:
-
-- **`agent-slack`** — Slack (user token, zero-config)
-- **`agent-slackbot`** — Slack Bot (bot token, for server-side/CI/CD)
-- **`agent-discord`** — Discord
-- **`agent-discordbot`** — Discord Bot (bot token, for server-side/CI/CD)
-- **`agent-teams`** — Microsoft Teams
-- **`agent-channeltalk`** — Channel Talk (beta, zero-config, extracted cookies)
-- **`agent-channeltalkbot`** — Channel Talk Bot (beta, API credentials, for server-side/CI/CD)
+Agent Messenger includes [Agent Skills](https://agentskills.io/) that teach your AI agent how to use each CLI above. One skill per CLI — install only what you need.
 
 ### SkillPad
 
 SkillPad is a GUI app for Agent Skills. See [skillpad.dev](https://skillpad.dev/) for more details.
 
-[![Available on SkillPad](https://badge.skillpad.dev/agent-slack/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-slack) [![Available on SkillPad](https://badge.skillpad.dev/agent-slackbot/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-slackbot) [![Available on SkillPad](https://badge.skillpad.dev/agent-discord/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-discord) [![Available on SkillPad](https://badge.skillpad.dev/agent-discordbot/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-discordbot) [![Available on SkillPad](https://badge.skillpad.dev/agent-teams/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-teams) [![Available on SkillPad](https://badge.skillpad.dev/agent-channeltalk/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-channeltalk) [![Available on SkillPad](https://badge.skillpad.dev/agent-channeltalkbot/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-channeltalkbot)
+[![Available on SkillPad](https://badge.skillpad.dev/agent-slack/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-slack) [![Available on SkillPad](https://badge.skillpad.dev/agent-slackbot/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-slackbot) [![Available on SkillPad](https://badge.skillpad.dev/agent-discord/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-discord) [![Available on SkillPad](https://badge.skillpad.dev/agent-discordbot/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-discordbot) [![Available on SkillPad](https://badge.skillpad.dev/agent-teams/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-teams) [![Available on SkillPad](https://badge.skillpad.dev/agent-telegram/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-telegram) [![Available on SkillPad](https://badge.skillpad.dev/agent-whatsapp/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-whatsapp) [![Available on SkillPad](https://badge.skillpad.dev/agent-whatsappbot/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-whatsappbot) [![Available on SkillPad](https://badge.skillpad.dev/agent-line/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-line) [![Available on SkillPad](https://badge.skillpad.dev/agent-instagram/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-instagram) [![Available on SkillPad](https://badge.skillpad.dev/agent-kakaotalk/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-kakaotalk) [![Available on SkillPad](https://badge.skillpad.dev/agent-channeltalk/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-channeltalk) [![Available on SkillPad](https://badge.skillpad.dev/agent-channeltalkbot/dark.svg)](https://skillpad.dev/install/devxoul/agent-messenger/agent-channeltalkbot)
 
 ### Skills CLI
 
@@ -125,38 +138,164 @@ agent-slack message send general "Hello from the CLI!"
 
 That's it. Credentials are extracted automatically from your Slack desktop app on first run. No OAuth flows. No API tokens. No configuration files.
 
+## Telegram Quick Start
+
+Get up and running with Telegram in a minute:
+
+```bash
+bunx --package agent-messenger agent-telegram auth login
+
+# Send a message
+bunx --package agent-messenger agent-telegram message send <chat-id-or-@username> "Hello from the CLI!"
+```
+
+The CLI automatically provisions API credentials via my.telegram.org if needed. For CI/CD, set `AGENT_TELEGRAM_API_ID` and `AGENT_TELEGRAM_API_HASH` environment variables.
+
+## SDK
+
+Use Agent Messenger as a TypeScript library. Each platform exports a typed client, credential manager, types, and Zod schemas.
+
+### Quick Example
+
+```typescript
+import { SlackClient } from 'agent-messenger/slack'
+
+const slack = await new SlackClient().login()
+const channels = await slack.listChannels()
+await slack.sendMessage(channels[0].id, 'Hello from the SDK!')
+```
+
+Credentials are resolved the same way as the CLI — auto-extracted from your desktop apps. Call `.login()` with no arguments for auto-extraction, or pass credentials explicitly:
+
+```typescript
+const slack = await new SlackClient().login({ token: 'xoxc-...', cookie: 'xoxd-...' })
+```
+
+### Available Imports
+
+| Import Path | Client |
+| --- | --- |
+| `agent-messenger/slack` | `SlackClient` |
+| `agent-messenger/slackbot` | `SlackBotClient` |
+| `agent-messenger/discord` | `DiscordClient` |
+| `agent-messenger/discordbot` | `DiscordBotClient` |
+| `agent-messenger/teams` | `TeamsClient` |
+| `agent-messenger/whatsapp` | `WhatsAppClient` |
+| `agent-messenger/whatsappbot` | `WhatsAppBotClient` |
+| `agent-messenger/line` | `LineClient` |
+| `agent-messenger/instagram` | `InstagramClient` |
+| `agent-messenger/kakaotalk` | `KakaoTalkClient` |
+| `agent-messenger/channeltalk` | `ChannelClient` |
+| `agent-messenger/channeltalkbot` | `ChannelBotClient` |
+
+Each module also exports its credential manager, Zod schemas, and TypeScript types:
+
+```typescript
+import { SlackClient, SlackCredentialManager, SlackMessageSchema } from 'agent-messenger/slack'
+import type { SlackMessage, SlackChannel } from 'agent-messenger/slack'
+```
+
+### Manual Credential Setup
+
+Every client supports `.login()` with explicit credentials for advanced use cases:
+
+```typescript
+import { SlackClient } from 'agent-messenger/slack'
+
+const client = await new SlackClient().login({ token: 'xoxc-...', cookie: 'xoxd-...' })
+const messages = await client.getMessages('C01234567')
+```
+
+### Real-time Events (Slack)
+
+```typescript
+import { SlackClient, SlackListener } from 'agent-messenger/slack'
+
+const client = await new SlackClient().login()
+const listener = new SlackListener(client)
+listener.on('message', (event) => {
+  console.log(`New message in ${event.channel}: ${event.text}`)
+})
+await listener.start()
+```
+
+### Real-time Events (KakaoTalk)
+
+```typescript
+import { KakaoTalkClient, KakaoTalkListener } from 'agent-messenger/kakaotalk'
+
+const client = await new KakaoTalkClient().login()
+const listener = new KakaoTalkListener(client)
+listener.on('message', (event) => {
+  console.log(`New message in ${event.chat_id}: ${event.message}`)
+})
+await listener.start()
+```
+
+## TUI (Experimental)
+
+A unified terminal interface for all your messaging platforms in one screen. Navigate between Slack, Discord, Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, and Channel Talk — all from your terminal.
+
+> **Note**: The TUI is a showcase of what's possible with Agent Messenger's SDK. It demonstrates the power of having a unified adapter layer across all platforms.
+
+```bash
+agent-messenger tui
+```
+
+![Agent Messenger TUI](docs/public/tui.png)
+
+Key features:
+- **Multi-platform** — All 9 platforms in one sidebar, auto-login on startup
+- **Real-time messages** — Live message streaming for supported platforms
+- **Fuzzy pickers** — `Ctrl+K` for channels, `Ctrl+W` for workspaces
+- **Interactive auth** — Authenticate platforms that aren't set up yet, right in the TUI
+
+See the [TUI docs](https://agent-messenger.dev/docs/tui) for keybindings, architecture, and more.
+
 ## Supported Platforms
 
-| Feature                    | Slack | Discord | Teams | Channel Talk (beta) |
-| -------------------------- | :---: | :-----: | :---: | :----------: |
-| Auto credential extraction |  ✅   |   ✅    |  ✅   |      ✅      |
-| Send & list messages       |  ✅   |   ✅    |  ✅   |      ✅      |
-| Search messages            |  ✅   |   ✅    |   —   |      ✅      |
-| Threads                    |  ✅   |   ✅    |   —   |      —       |
-| Channels & Users           |  ✅   |   ✅    |  ✅   |      ✅      |
-| Reactions                  |  ✅   |   ✅    |  ✅   |      —       |
-| File uploads               |  ✅   |   ✅    |  ✅   |      —       |
-| File downloads             |  ✅   |    —    |   —   |      —       |
-| Workspace snapshots        |  ✅   |   ✅    |  ✅   |      ✅      |
-| Multi-workspace            |  ✅   |   ✅    |  ✅   |      ✅      |
-| Activity feed              |  ✅   |    —    |   —   |      —       |
-| Drafts                     |  ✅   |    —    |   —   |      —       |
-| Saved items                |  ✅   |    —    |   —   |      —       |
-| Unread messages            |  ✅   |    —    |   —   |      —       |
-| Sidebar sections           |  ✅   |    —    |   —   |      —       |
-| Bot support                |  ✅   |   ✅    |   —   |      ✅      |
+| Feature                    | Slack | Discord | Teams | Telegram | WhatsApp | LINE  | Instagram | KakaoTalk | Channel Talk (beta) |
+| -------------------------- | :---: | :-----: | :---: | :------: | :------: | :---: | :-------: | :-------: | :-----------------: |
+| Auto credential extraction |  ✅   |   ✅    |  ✅   |    —     |    —     |   —   |     —     |    ✅     |         ✅          |
+| Send & list messages       |  ✅   |   ✅    |  ✅   |    ✅     |    ✅     |  ✅   |    ✅     |    ✅     |         ✅          |
+| Search messages            |  ✅   |   ✅    |   —   |    —     |    ✅     |   —   |    ✅     |    —      |         ✅          |
+| Threads                    |  ✅   |   ✅    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Channels & Users           |  ✅   |   ✅    |  ✅   | partial  |    —     |  ✅   |     —     |    —      |         ✅          |
+| Reactions                  |  ✅   |   ✅    |  ✅   |    —     |    ✅     |   —   |     —     |    —      |         —           |
+| File uploads               |  ✅   |   ✅    |  ✅   |    —     |    —     |   —   |     —     |    —      |         —           |
+| File downloads             |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Workspace snapshots        |  ✅   |   ✅    |  ✅   |    —     |    —     |   —   |     —     |    —      |         ✅          |
+| Multi-workspace / account  |  ✅   |   ✅    |  ✅   |    ✅     |    ✅     |  ✅   |    ✅     |    ✅     |         ✅          |
+| Activity feed              |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Drafts                     |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Saved items                |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Unread messages            |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Sidebar sections           |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Pins & bookmarks           |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Scheduled messages         |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Channel management         |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Reminders                  |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| User groups                |  ✅   |    —    |   —   |    —     |    —     |   —   |     —     |    —      |         —           |
+| Real-time events (SDK)     |  ✅   |    ✅    |   —   |    —     |    —     |  ✅   |    ✅     |    ✅      |         —           |
+| Bot support                |  ✅   |   ✅    |   —   |    —     |    ✅     |   —   |     —     |    —      |         ✅          |
 
 > ⚠️ **Teams tokens expire in 60-90 minutes.** Re-run `agent-teams auth extract` to refresh. See [Teams Guide](skills/agent-teams/SKILL.md) for details.
 
 ## Platform Guides
 
-- **[Slack Guide](https://agent-messenger.dev/docs/integrations/slack)** — Full command reference for Slack
-- **[Slack Bot Guide](https://agent-messenger.dev/docs/integrations/slackbot)** — Bot token integration for server-side and CI/CD
-- **[Discord Guide](https://agent-messenger.dev/docs/integrations/discord)** — Full command reference for Discord
-- **[Discord Bot Guide](https://agent-messenger.dev/docs/integrations/discordbot)** — Bot token integration for server-side and CI/CD
-- **[Teams Guide](https://agent-messenger.dev/docs/integrations/teams)** — Full command reference for Microsoft Teams
-- **[Channel Talk Guide](https://agent-messenger.dev/docs/integrations/channeltalk)** — Full command reference for Channel Talk (beta, zero-config)
-- **[Channel Talk Bot Guide](https://agent-messenger.dev/docs/integrations/channeltalkbot)** — Bot API integration for Channel Talk (beta)
+- **[Slack Guide](https://agent-messenger.dev/docs/cli/slack)** — Full command reference for Slack
+- **[Slack Bot Guide](https://agent-messenger.dev/docs/cli/slackbot)** — Bot token integration for server-side and CI/CD
+- **[Discord Guide](https://agent-messenger.dev/docs/cli/discord)** — Full command reference for Discord
+- **[Discord Bot Guide](https://agent-messenger.dev/docs/cli/discordbot)** — Bot token integration for server-side and CI/CD
+- **[Teams Guide](https://agent-messenger.dev/docs/cli/teams)** — Full command reference for Microsoft Teams
+- **[Telegram Guide](https://agent-messenger.dev/docs/cli/telegram)** — TDLib setup and Telegram command reference
+- **[WhatsApp Guide](https://agent-messenger.dev/docs/cli/whatsapp)** — Baileys-based WhatsApp integration via pairing code
+- **[WhatsApp Bot Guide](https://agent-messenger.dev/docs/cli/whatsappbot)** — Cloud API integration for WhatsApp Business
+- **[LINE Guide](https://agent-messenger.dev/docs/cli/line)** — QR code login and Thrift protocol integration
+- **[Instagram Guide](https://agent-messenger.dev/docs/cli/instagram)** — Instagram DM integration via private mobile API
+- **[KakaoTalk Guide](https://agent-messenger.dev/docs/cli/kakaotalk)** — Sub-device login and LOCO protocol integration
+- **[Channel Talk Guide](https://agent-messenger.dev/docs/cli/channeltalk)** — Full command reference for Channel Talk (beta, zero-config)
+- **[Channel Talk Bot Guide](https://agent-messenger.dev/docs/cli/channeltalkbot)** — Bot API integration for Channel Talk (beta)
 
 ## Use Cases
 
@@ -204,13 +343,28 @@ Wire messaging into your CI, scripts, or agent workflows.
 
 ### ...and More
 
-These are just starting points. Your agent has full read/write access to Slack, Discord, Teams, and Channel Talk — anything you'd do manually in a chat app, it can handle for you. If you build something cool with Agent Messenger, [let me know](https://x.com/devxoul)!
+These are just starting points. Your agent has full read/write access to Slack, Discord, Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, and Channel Talk — anything you'd do manually in a chat app, it can handle for you. If you build something cool with Agent Messenger, [let me know](https://x.com/devxoul)!
 
 ## Philosophy
 
-**Why not MCP?** MCP servers expose all tools at once, bloating context and confusing agents. **[Agent Skills](https://agentskills.io/) + agent-friendly CLI** offer a better approach—load what you need, when you need it. Fewer tokens, cleaner context, better output.
+### Why CLI, not MCP?
+
+MCP servers expose all tools at once, bloating context and confusing agents.
+
+| MCP Approach | Agent Skills + CLI |
+| --- | --- |
+| All tools loaded at once | Load only what you need |
+| Bloated context window | Minimal token usage |
+| Agent confused by options | Focused, relevant tools |
+| Requires a running server | One shell command per action |
+
+With Agent Messenger, your agent loads the skill it needs, uses the CLI, and moves on. No wasted tokens. The SDK complements the CLI for when you need programmatic access—same credentials, same platform coverage, full type safety.
+
+### Why not OAuth?
+
+OAuth requires creating an app and workspace admin approval—days of waiting just to send a message. Agent Messenger skips all of that. Your desktop apps already have valid session tokens; Agent Messenger extracts them directly so you can start messaging immediately. For platforms like Telegram, WhatsApp, and LINE, a one-time authentication flow gets you in fast.
 
-**Why not OAuth?** OAuth requires an app and it requires workspace admin approval to install, which can take days. This tool just works—zero setup required. For those who prefer bot tokens (e.g., server-side or CI/CD), see [`agent-slackbot`](skills/agent-slackbot/SKILL.md).
+For server-side bots and CI/CD, bot tokens are fully supported via [`agent-slackbot`](skills/agent-slackbot/SKILL.md), [`agent-discordbot`](skills/agent-discordbot/SKILL.md), [`agent-whatsappbot`](skills/agent-whatsappbot/SKILL.md), and [`agent-channeltalkbot`](skills/agent-channeltalkbot/SKILL.md).
 
 Inspired by [agent-browser](https://github.com/vercel-labs/agent-browser) from Vercel Labs.
 
@@ -220,8 +374,11 @@ Inspired by [agent-browser](https://github.com/vercel-labs/agent-browser) from V
 bun install    # Install dependencies
 bun link       # Link CLI globally for local testing
 bun test       # Run tests
+bun test:e2e   # Run e2e tests
 bun typecheck  # Type check
 bun lint       # Lint
+bun lint:fix   # Lint with autofix
+bun format     # Format
 bun run build  # Build
 ```