Skip to content

devxoul/agent-messenger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

357 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Agent Messenger

npm version SkillPad - agent-slack SkillPad - agent-slackbot SkillPad - agent-discord SkillPad - agent-discordbot SkillPad - agent-teams

Agent Messenger

Give your AI agent the power to read and send messages across Slack, Discord, Teams and more

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.

Table of Contents

πŸ€” 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.

  • 🎭 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)
  • πŸ€– AI-agent friendly β€” JSON output by default, perfect for LLM tool use
  • πŸ‘€ Human friendly too β€” Add --pretty for readable output
  • ⚑ Token efficient β€” CLI, not MCP. Load only what you need. (Why not MCP?)

πŸ“¦ Installation

npm install -g agent-messenger

Or use your favorite package manager.

This installs:

  • agent-slack β€” Slack CLI (user token, zero-config)
  • agent-slackbot β€” Slack Bot CLI (bot token, for server-side/CI/CD)
  • agent-discord β€” Discord CLI
  • agent-discordbot β€” Discord Bot CLI (bot token, for server-side/CI/CD)
  • agent-teams β€” Microsoft Teams CLI

🧩 Agent Skills

Agent Messenger includes Agent Skills that teach your AI agent how to use these CLIs effectively. Five 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

SkillPad

SkillPad is a GUI app for Agent Skills. See skillpad.dev for more details.

Available on SkillPad Available on SkillPad Available on SkillPad Available on SkillPad Available on SkillPad

Skills CLI

Skills CLI is a CLI tool for Agent Skills. See skills.sh for more details.

npx skills add devxoul/agent-messenger

Claude Code Plugin

claude plugin marketplace add devxoul/agent-messenger
claude plugin install agent-messenger

Or within Claude Code:

/plugin marketplace add devxoul/agent-messenger
/plugin install agent-messenger

OpenCode Plugin

Add to your opencode.jsonc:

{
  "plugins": [
    "agent-messenger"
  ]
}

πŸš€ Quick Start

Get up and running in 30 seconds:

# 1. See your workspace at a glance
agent-slack snapshot --pretty

# 2. Send a message
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.

πŸ“‹ Supported Platforms

Feature Slack Discord Teams
Auto credential extraction βœ… βœ… βœ…
Send & list messages βœ… βœ… βœ…
Search messages βœ… βœ… β€”
Threads βœ… βœ… β€”
Channels & Users βœ… βœ… βœ…
Reactions βœ… βœ… βœ…
File uploads βœ… βœ… βœ…
Workspace snapshots βœ… βœ… βœ…
Multi-workspace βœ… βœ… βœ…
Activity feed βœ… β€” β€”
Drafts βœ… β€” β€”
Saved items βœ… β€” β€”
Unread messages βœ… β€” β€”
Sidebar sections βœ… β€” β€”
Bot support βœ… βœ… β€”

⚠️ Teams tokens expire in 60-90 minutes. Re-run agent-teams auth extract to refresh. See Teams Guide for details.

πŸ“– Platform Guides

πŸ’‘ Use Cases

Gathering Context

Pull context from conversations before you start working β€” no tab-switching, no skimming.

"Read the #incident-api-outage thread in Slack and summarize the root cause, timeline, and action items so I can write the postmortem."

"Search our Discord #architecture channel for any previous discussion about event sourcing before I write a proposal."

"Check my unread messages across all Slack channels and tell me if anything needs my attention."

"Look through #frontend in Slack for messages about the login page redesign from the past two weeks and summarize the decisions made."

"Search Teams for any messages mentioning 'API deprecation' so I know if this was discussed before."

Communicating & Reporting

Send updates, file reports, and notify your team β€” all from a prompt.

"Post a deployment summary to #releases in Slack with the commit hash, changelog, and deploy status."

"Send a message to the #standup channel with what I worked on yesterday, what I'm doing today, and any blockers."

"Cross-post this announcement to #general in Slack, the announcements channel in Discord, and the General channel in Teams."

"Upload the latest test coverage report to #ci-results in Slack."

"React with βœ… to the last message in #deploy-requests to confirm I've handled it."

Automation & Pipelines

Wire messaging into your CI, scripts, or agent workflows.

"After every CI run, post the build status and test results to #builds in Slack β€” include the branch name and commit link."

"When a long-running migration finishes, notify me in Discord with the final row count and elapsed time."

"Every morning at 9am, snapshot my Slack workspace and post a summary of active channels to #team-pulse."

"Send an alert to #oncall in Slack whenever the error rate exceeds 1% β€” include the service name and a link to the dashboard."

"Read the latest message in #releases, then cross-post it to our Discord announcements channel."

...and More

These are just starting points. Your agent has full read/write access to Slack, Discord, and Teams β€” 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!

πŸ’­ Philosophy

Why not MCP? MCP servers expose all tools at once, bloating context and confusing agents. Agent Skills + agent-friendly CLI offer a better approachβ€”load what you need, when you need it. Fewer tokens, cleaner context, better output.

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.

Inspired by agent-browser from Vercel Labs.

🀝 Contributing

bun install    # Install dependencies
bun link       # Link CLI globally for local testing
bun test       # Run tests
bun typecheck  # Type check
bun lint       # Lint
bun run build  # Build

πŸ“„ License

MIT

About

Slack, Discord, Teams automation CLI for AI agents

Topics

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors