AgentIO

Run LLM agent workflows in GitHub Actions.
No servers. No Zapier. Just cron.

A CLI that lets LLM agents interact with Gmail, Slack, JIRA, Telegram, and more. Designed for CI/CD pipelines and scheduled automation.

Why AgentIO?

Send a daily Slack summary of unread emails

Monitor RSS feeds and post to Telegram

Update JIRA tickets based on email threads

Run on a schedule, without managing servers

Install

macOS / Linux
Windows
curl -LsSf https://agentio.me/install | sh
iwr -useb https://agentio.me/install.ps1 | iex
Update: agentio update

How It Works

1

Authenticate locally

Add your accounts once on your machine. OAuth flows open in your browser.

agentio gmail profile add
agentio slack profile add
2

Export your config

All credentials are encrypted with AES-256-GCM. Store the file and key in CI/CD secrets.

agentio config export
# Outputs: agentio.config + encryption key
3

Run anywhere

Import your config from environment variables and use any service.

agentio config import
agentio gmail list --limit 10

Example Workflow

.github/workflows/daily-briefing.yml
name: Daily Briefing
on:
  schedule:
    - cron: '0 7 * * 1-5'  # Weekdays at 7 AM

jobs:
  briefing:
    runs-on: ubuntu-latest
    env:
      AGENTIO_CONFIG: ${{ secrets.AGENTIO_CONFIG }}
      AGENTIO_KEY: ${{ secrets.AGENTIO_KEY }}
      CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
    steps:
      - uses: actions/checkout@v4
      - run: curl -LsSf https://agentio.me/install | sh
      - run: npm install -g @anthropic-ai/claude-code
      - run: agentio config import && agentio claude install
      - run: claude -p "$(cat prompt.md)" --max-turns 30
See examples/ for complete working workflows.

Supported Services

Service Auth Commands
Gmail OAuth list get search send reply archive
Slack Webhook send
Telegram Bot Token send
Google Chat Webhook/OAuth send list get
JIRA OAuth projects search get comment transition
Discourse API Key list get categories
RSS None articles get info

Design Principles

LLM-friendly output

Structured text output optimized for AI parsing and reasoning.

Stdin support

Pipe content directly to commands. Works great with LLM-generated text.

Portable config

One encrypted file + key = full portability across any CI/CD platform.

Multi-profile

Manage multiple accounts per service with named profiles.

No dependencies

Single binary. No runtime dependencies. Runs anywhere.

Claude Code ready

Install skills so Claude can access services directly in conversations.

Alternative Installation

Homebrew brew tap plosson/agentio && brew install agentio
Scoop scoop bucket add agentio https://github.com/plosson/scoop-agentio && scoop install agentio
npm npm install -g @plosson/agentio
Direct Download from GitHub Releases