vibekit-remote-agent

Control your local Claude Code from Telegram. Ship code from your phone.

Free to use - works with your existing Claude Pro/Max subscription.

Installation

npm install -g vibekit-remote-agent

Quick Start

1. Get a link code from Telegram:

   • Open @the_vibe_kit_bot
   • Send /remote to get your link code

2. Link your computer:

   npx vibekit-remote-agent link

   Enter the code when prompted.

3. Start the agent:

   npx vibekit-remote-agent start

4. Send messages via Telegram - they'll be executed by Claude Code on your machine.

Features

• Text messages - Chat naturally, Claude responds
• Voice messages - Send voice notes, Claude listens and responds
• Images & screenshots - Send photos for analysis or debugging
• Document uploads - Share files for Claude to work with
• Conversation memory - Claude remembers context within a session

Telegram Commands

Once connected, use these commands in the bot:

| Command | Description | |---------|-------------| | /remote | View status, new chat, disconnect | | /stop | Cancel running task | | /status | View connection status |

Commands

| Command | Description | |---------|-------------| | vibekit-remote-agent link | Link this computer to your Telegram account | | vibekit-remote-agent start | Start the remote agent | | vibekit-remote-agent start -d /path/to/project | Start in a specific directory | | vibekit-remote-agent status | Show connection status | | vibekit-remote-agent logout | Remove stored credentials | | vibekit-remote-agent config | View current configuration |

Tool Permissions

By default, the agent runs with a safe set of read-only tools. You can configure which tools Claude Code can use:

# View current tools
vibekit-remote-agent config

# Set specific tools
vibekit-remote-agent config --tools "WebSearch,Bash,Read,Write,Edit"

# Reset to safe defaults
vibekit-remote-agent config --reset-tools

# Enable all tools (use with caution)
vibekit-remote-agent config --all-tools

Default safe tools: WebSearch, WebFetch, Read, Glob, Grep

Available tools: WebSearch, WebFetch, Bash, Read, Write, Edit, Glob, Grep

How It Works

1. The agent runs on your local machine
2. It connects to VibeKit's server via WebSocket
3. When you send a message via Telegram, it's relayed to your local agent
4. Claude Code executes the request and sends results back to Telegram

Requirements

• Node.js 18+
• Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
• A VibeKit account (free to start)

Troubleshooting

"No token found" - Run vibekit-remote-agent link first

"Connection lost" - Check your internet connection and restart with vibekit-remote-agent start

"Claude Code not found" - Install Claude Code: npm install -g @anthropic-ai/claude-code

Links

• VibeKit Website
• Telegram Bot
• GitHub

License

MIT