VibeKit logo VibeKit Enter App

VibeKit Remote Agent — Drive Your Laptop's Claude Code from iPhone

A small Node CLI you install on your laptop. It links to your VibeKit account, listens for tasks from your iPhone or Telegram, and runs Claude Code locally against your real codebase. Same agent loop, same model quality — your phone is just the input device.

Install + link

npm install -g vibekit-agent
vibekit-agent link

Latest published version: [email protected]. The link command prints a code; open the iOS app or Telegram bot, paste it under Remote Agents, done. Then:

cd ~/code/your-project
vibekit-agent start

The agent now listens. Send a task from iOS ("fix the 500 on /api/users"), the agent runs Claude Code in this directory, commits the fix, and sends the result back to your phone.

Commands

vibekit-agent link
Pair this machine with your VibeKit account. Generates a one-time code you enter in the iOS app or Telegram.
vibekit-agent start [--directory <path>]
Start listening for remote tasks. Defaults to the current directory; --directory changes scope.
vibekit-agent status
Show whether this machine is linked and what user it's linked to.
vibekit-agent config --tools <list>
Whitelist which Claude Code tools the remote operator can invoke (default = safe set).
vibekit-agent logout
Clear stored credentials. The pairing on the iOS / Telegram side stays until you remove it there too.

Why outbound WebSocket (not SSH / tunnel)

The agent opens a WebSocket to app.vibekit.bot as a normal HTTPS connection. No inbound ports, no SSH config, no ngrok. Works behind corporate firewalls, hotel wifi, NAT — anywhere an outbound HTTPS call goes through.

The gateway sits between your laptop and the mobile client. Your laptop never has a public address.

Hosted app vs Remote agent — when to use which

 Hosted app on VibeKitRemote agent (vibekit-agent)
Where the code livesVibeKit's EFSYour laptop's disk
Where the agent runsVibeKit FargateYour laptop's CPU
Stays online when laptop sleeps?YesNo
Has a public URL?Yes (*.vibekit.bot)No (local-only)
Best forApps you want to ship + shareDriving your existing local project from your phone

Tool safety

The agent inherits Claude Code's tool model. By default, the operator from your phone can only invoke a safe set (file reads, file writes inside the workspace, Bash with whitelisted prefixes). You can broaden or narrow this with vibekit-agent config --tools.

If you're skittish: link a project-specific worktree (git worktree add ../scratch) and run the agent against that, so even if you tell the operator something rash, the blast radius is limited.

Related packages

Drive your laptop's Claude Code from iPhone
npm i -g vibekit-agent · link · start · phone becomes the input device
Get the iOS App →