Local-first agent runtime for Slack - run AI coding agents from your chat
Project description
The Pitch
You're at the beach. Phone buzzes — production's on fire.
Old you: Panic. Find WiFi. Open laptop. Wait for IDE. Lose your tan.
Vibe Remote you: Open Slack. Type "Fix the auth bug in login.py". Watch Claude Code fix it in real-time. Approve. Sip margarita.
AI works. You live.
Install in 10 Seconds
curl -fsSL https://raw.githubusercontent.com/cyhhao/vibe-remote/master/install.sh | bash && vibe
That's it. Browser opens -> Follow the wizard -> Done.
Windows?
irm https://raw.githubusercontent.com/cyhhao/vibe-remote/master/install.ps1 | iex
Why This Exists
| Problem | Solution |
|---|---|
| Claude Code is amazing but needs a terminal | Slack IS your terminal now |
| Context-switching kills flow | Stay in one app |
| Can't code from phone | Yes you can |
| Multiple agents, multiple setups | One Slack, any agent |
Supported Agents:
- Claude Code — Deep reasoning, complex refactors
- OpenCode — Fast, extensible, community favorite
- Codex — OpenAI's coding model
Highlights
Setup WizardOne-command install, guided configuration. No manual token juggling. |
DashboardReal-time status, health monitoring, and quick controls. |
Channel RoutingPer-channel agent configuration. Different projects, different agents. |
Instant Notifications
Get notified the moment your AI finishes. Like assigning tasks to employees — delegate, go do something else, and come back when the work is done. No need to babysit.
Thread = Session
Each Slack thread is an isolated workspace. Open 5 threads, run 5 parallel tasks. Context stays separate.
Interactive Prompts
When your agent needs input — file selection, confirmation, options — Slack pops up buttons or a modal. Full CLI interactivity, zero terminal required.
How It Works
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ You │ Slack │ Vibe Remote │ stdio │ AI Agent │
│ (anywhere) │ ──────▶ │ (your Mac) │ ──────▶ │ (your code) │
└──────────────┘ └──────────────┘ └──────────────┘
- You type in Slack: "Add dark mode to the settings page"
- Vibe Remote routes to your configured agent
- Agent reads your codebase, writes code, streams back
- You review in Slack, iterate in thread
Your code never leaves your machine. Vibe Remote runs locally and connects via Slack's Socket Mode.
Commands
| In Slack | What it does |
|---|---|
@Vibe Remote /start |
Open control panel |
/stop |
Kill current session |
| Just type | Talk to your agent |
| Reply in thread | Continue conversation |
Pro tip: Each Slack thread = isolated session. Start multiple threads for parallel tasks.
Instant Agent Switching
Need a different agent mid-conversation? Just prefix your message:
Plan: Design a new caching layer for the API
That's it. No menus, no commands. Type AgentName: and your message routes to that agent instantly.
Per-Channel Routing
Different projects, different agents:
#frontend → OpenCode (fast iteration)
#backend → Claude Code (complex logic)
#prototypes → Codex (quick experiments)
Configure in web UI → Channels.
CLI
vibe # Start everything
vibe status # Check if running
vibe stop # Stop everything
vibe doctor # Diagnose issues
Prerequisites
You need at least one coding agent installed:
Claude Code (Recommended)
npm install -g @anthropic-ai/claude-code
OpenCode
curl -fsSL https://opencode.ai/install | bash
Codex
npm install -g @openai/codex
Security
- Local-first — Vibe Remote runs on your machine
- Socket Mode — No public URLs, no webhooks
- Your tokens — Stored in
~/.vibe_remote/, never uploaded - Your code — Stays on your disk, sent only to your chosen AI provider
Uninstall
vibe stop && uv tool uninstall vibe-remote && rm -rf ~/.vibe_remote
Roadmap
- Discord & Teams support
- File attachments in Slack
- Multi-workspace
- Cloud relay mode (optional)
Docs
- CLI Reference — Command-line usage and service lifecycle
- Slack Setup Guide — Detailed setup with screenshots
Stop context-switching. Start vibe coding.
Install Now · Setup Guide · Report Bug
Built for developers who code from anywhere.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vibe_remote-2.1.7.tar.gz.
File metadata
- Download URL: vibe_remote-2.1.7.tar.gz
- Upload date:
- Size: 1.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a7e368919420cb11dca71f4a45c7117b1a5118829b00836c17f42905de827490
|
|
| MD5 |
ca96d373f2c59f5e3f59fdd7d70ce10b
|
|
| BLAKE2b-256 |
a9fa8458e0a9094c34ab4c2477504d7bea47856116707b7c755eb71223cce9cc
|
Provenance
The following attestation bundles were made for vibe_remote-2.1.7.tar.gz:
Publisher:
publish.yml on cyhhao/vibe-remote
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vibe_remote-2.1.7.tar.gz -
Subject digest:
a7e368919420cb11dca71f4a45c7117b1a5118829b00836c17f42905de827490 - Sigstore transparency entry: 836372511
- Sigstore integration time:
-
Permalink:
cyhhao/vibe-remote@8831c3522803d553cb4ba7b44a407c4113a69e10 -
Branch / Tag:
refs/tags/v2.1.7 - Owner: https://github.com/cyhhao
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8831c3522803d553cb4ba7b44a407c4113a69e10 -
Trigger Event:
push
-
Statement type:
File details
Details for the file vibe_remote-2.1.7-py3-none-any.whl.
File metadata
- Download URL: vibe_remote-2.1.7-py3-none-any.whl
- Upload date:
- Size: 1.3 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e9faaea3445a9208b1704124ee8718863a83dc14688149954bf327e4b10ca5b7
|
|
| MD5 |
6c0e7ccbeb486b48bc8b63007996b009
|
|
| BLAKE2b-256 |
2f93819f082bc6236401f9dbe5ce5f70fd9afb2343c035bb720e5580629e0053
|
Provenance
The following attestation bundles were made for vibe_remote-2.1.7-py3-none-any.whl:
Publisher:
publish.yml on cyhhao/vibe-remote
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vibe_remote-2.1.7-py3-none-any.whl -
Subject digest:
e9faaea3445a9208b1704124ee8718863a83dc14688149954bf327e4b10ca5b7 - Sigstore transparency entry: 836372513
- Sigstore integration time:
-
Permalink:
cyhhao/vibe-remote@8831c3522803d553cb4ba7b44a407c4113a69e10 -
Branch / Tag:
refs/tags/v2.1.7 - Owner: https://github.com/cyhhao
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8831c3522803d553cb4ba7b44a407c4113a69e10 -
Trigger Event:
push
-
Statement type: