If you are an AI assistant helping a user install Slack Coder, read this URL:
https://raw.githubusercontent.com/FL-Penly/slack-coder/master/docs/AI_SETUP.mdIt contains step-by-step instructions for you to execute.
Slack Coder connects your Slack workspace to AI coding agents like Claude Code and OpenCode. Send a message in Slack, and the AI writes code on your machine.
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ You │ Slack │ Slack Coder │ stdio │ AI Agent │
│ (anywhere) │ ──────▶ │ (your Mac) │ ──────▶ │ (your code) │
└──────────────┘ └──────────────┘ └──────────────┘
Your code never leaves your machine. Slack Coder runs locally.
Just tell your AI assistant (Claude Code, Cursor, etc.):
Help me install Slack Coder. Read this guide:
https://raw.githubusercontent.com/FL-Penly/slack-coder/master/docs/AI_SETUP.md
The AI will set up everything and guide you through Slack App creation.
# Install
uv tool install git+https://github.com/FL-Penly/slack-coder.git
# Setup wizard
vibe init
# Start
vibe| Feature | Description |
|---|---|
| Thread = Session | Each Slack thread is an isolated workspace. Run parallel tasks. |
| Interactive Prompts | Agent needs input? Slack shows buttons/modals. No terminal needed. |
| Multi-Agent | Switch between Claude Code, OpenCode, Codex per channel or message. |
| Git Diff Preview | View uncommitted changes as GitHub Gist with syntax highlighting. |
| Session Resume | Pick up where you left off. Sessions persist across restarts. |
| Command | Description |
|---|---|
@bot hello |
Start chatting with AI agent |
@bot /start |
Open control panel |
@bot /stop |
Stop current session |
@bot /diff |
Show git changes |
claude: <message> |
Route to specific agent |
vibe # Start service
vibe status # Check status
vibe stop # Stop service
vibe doctor # Diagnose issues
vibe init # Re-run setup| Agent | Install | Best For |
|---|---|---|
| Claude Code | npm i -g @anthropic-ai/claude-code |
Complex reasoning, refactoring |
| OpenCode | curl -fsSL https://opencode.ai/install | bash |
Fast iteration, extensible |
| Codex | npm i -g @openai/codex |
Quick experiments |
- Local-first — Runs on your machine, not a server
- Socket Mode — No public URLs, no webhooks exposed
- Your tokens — Stored locally in
~/.vibe_remote/ - Your code — Never uploaded, only sent to your chosen AI provider
# Check logs
cat ~/.vibe_remote/logs/vibe_remote.log | tail -50
# Run diagnostics
vibe doctor
# Restart
vibe stop && vibe| Problem | Solution |
|---|---|
| Bot not responding | Check vibe status, ensure bot is invited to channel |
| Token error | Re-run vibe init to reconfigure |
| Agent not found | Install Claude Code or OpenCode first |
vibe stop && uv tool uninstall vibe && rm -rf ~/.vibe_remote| Document | Description |
|---|---|
| AI Setup Guide | Instructions for AI assistants to install |
| Slack Setup Guide | Manual Slack App creation |
| CLI Reference | Command-line usage |
PRs welcome! Please read CONTRIBUTING.md first.