🔧 slackogo

Slack, but make it terminal.

Power CLI using web cookies. Read channels, send messages, search, and script with JSON/plain output.

---

Your already logged-in Slack workspace — the agent can use it directly. No admin permissions, no OAuth app registration, no rate limits.

AI Agent (Claude, GPT, etc.)
       │ CLI commands
       ▼
   slackogo CLI ──HTTP──▶ Slack Web API
                              │
                        xoxc- token + d cookie
                        (from your browser session)

Why Not a Slack App?

	Slack App / Bot Token	slackogo
Setup	Register app, get admin approval, configure OAuth	Import cookies from Chrome
Permissions	Scoped, limited by admin	Full access — anything you can do in Slack
Rate limits	Strict (tier 1-4)	Web client limits (generous)
Internal channels	Need explicit permission	If you can see it, slackogo can too
Enterprise Grid	Complex multi-workspace auth	Just import cookies per workspace
Canvases	API requires scopes + admin approval	Read/write through your own session

Install

From source

git clone https://github.com/DaleXiao/slackogo.git
cd slackogo
go build ./cmd/slackogo/

Go install

go install github.com/DaleXiao/slackogo/cmd/slackogo@latest

Download binary

Grab a pre-built binary from Releases (macOS arm64, Windows amd64/arm64).

Quick Start

1. Get your credentials

Option A: Import from browser (recommended)

# Step 1: Start Edge with CDP enabled
# Windows:
msedge.exe --remote-debugging-port=9222
# macOS:
/Applications/Microsoft\ Edge.app/Contents/MacOS/Microsoft\ Edge --remote-debugging-port=9222

# Step 2: Open your Slack workspace in that browser window

# Step 3: Import (extracts cookie locally + token via CDP — no extra HTTP requests)
slackogo auth import --browser edge -t your-workspace

For non-Enterprise workspaces, CDP is optional:

slackogo auth import --browser chrome
slackogo auth import --browser edge --no-cdp

Supported browsers for cookie extraction: Chrome, Edge, Brave, Firefox, Safari.

Option B: Manual setup

If automatic import doesn't work, set credentials manually:

Open your browser → Slack workspace → F12:

• d cookie: Application → Cookies → .slack.com → d
• xoxc- token: Network → filter api/ → any request's form data → token

slackogo auth manual --token xoxc-YOUR-TOKEN --cookie "YOUR-D-COOKIE" your-team

2. Verify

slackogo auth status

3. Go

slackogo channel list                    # List channels
slackogo channel read general --limit 10 # Read messages
slackogo channel send general "Hello!"   # Send message
slackogo dm send @alice "Hi there"       # Send DM
slackogo search "quarterly report"       # Search messages

Commands

Auth

slackogo auth import --browser chrome     # Import cookies from Chrome
slackogo auth manual --token T --cookie C # Set credentials manually
slackogo auth status                      # Check auth status

Channels

slackogo channel list                     # List all channels
slackogo channel read CHANNEL [--limit N] # Read messages
slackogo channel send CHANNEL "message"   # Send a message

Direct Messages

slackogo dm list                          # List DM conversations
slackogo dm read USER [--limit N]         # Read DMs with a user
slackogo dm send USER "message"           # Send a DM

Search & Info

slackogo search "query" [--limit N]       # Search messages
slackogo user list [--limit N]            # List workspace users
slackogo user info USER                   # User details
slackogo workspace list                   # List workspaces
slackogo status                           # Connection status

Canvases (SPEC-050 / SPEC-056 / SPEC-058)

slackogo canvas list [--channel C123] [--limit 100]
slackogo canvas get CANVAS_ID [-o md|json|raw]
slackogo canvas create --title "My doc" [--channel C123] [--from-file body.md] [--body "# inline"]
slackogo canvas edit CANVAS_ID --op replace --section S1 --from-file new.md
slackogo canvas edit CANVAS_ID --op insert_at_end --body "## Footer"
slackogo canvas delete CANVAS_ID
slackogo canvas access set CANVAS_ID --user U1 --user U2 --level read
slackogo canvas access delete CANVAS_ID --user U1

Canvas edit ops: insert_at_start / insert_at_end / insert_before / insert_after / replace / delete.

CANVAS_ID must be an F-prefix file ID (e.g. F0ASWF3SRST) — use canvas list to find them. The legacy Q-prefix "Quip" IDs are rejected client-side.

canvas list calls files.list?types=canvas (singular, per Slack docs) and filters to canvas filetype. canvas get:

• with no -o flag: prints files.info metadata only.
• -o raw: fetches file.url_private_download with the workspace Bearer token + cookie and writes the bytes verbatim (use this when you want the original payload).
• -o md: same fetch, then either returns the body verbatim (Slack canvas bodies are markdown by design) or extracts the markdown / body field if Slack wraps the payload in a JSON envelope.
• -o json: returns the parsed envelope when Slack ships JSON, otherwise wraps the markdown text as {"markdown": "..."}.

Output Modes

slackogo channel list                     # Human-readable (colorized)
slackogo channel list --plain             # Tab-separated (for scripts)
slackogo channel list --json              # Structured JSON (for agents)

Respects NO_COLOR and TERM=dumb.

Global Flags

Flag	Description
--json	JSON output
--plain	Tab-separated output
--no-color	Disable colors
-w, --workspace	Select workspace
--timeout	Request timeout (default 10s)
-q / -v / -d	Quiet / Verbose / Debug
--version	Show version

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid usage
3	Auth failure
4	Network error

How It Works

Slack's web client authenticates with an xoxc- token paired with a d cookie. slackogo reuses these credentials to call the same Web API endpoints that app.slack.com uses — no OAuth, no bot tokens, no admin approval.

Credentials are stored locally in ~/.config/slackogo/.

Features

• One-command setup — cookie extraction + CDP token discovery, zero extra HTTP requests
• Enterprise Grid safe — uses CDP to read tokens from your already-open browser tab, never triggers security detection
• Browser fingerprint — API requests mimic real Edge browser headers
• Cookie rotation — automatically captures and persists Slack's rotated d cookie

Project Structure

slackogo/
├── cmd/slackogo/        # CLI entry point
├── internal/            # Go packages (api, auth, output, app)
├── .github/workflows/   # Release automation
├── .gitignore
├── LICENSE
└── README.md

Security

• Credentials stay on your machine (~/.config/slackogo/)
• No data sent to third parties
• You're using your own Slack session
• Use responsibly and in accordance with your organization's policies

Inspired By

spogo — Spotify power CLI using web cookies. Same philosophy: if the web client can do it, so can the terminal.

License

MIT