Busymote Agent Remote (CLI)

Run your terminal AI agent (Claude Code, Codex, Aider, Gemini CLI…) inside Busymote so you can watch it and answer its prompts from your phone.

Install

Needs Node 18+.

npm i -g busymote-agent   # pulls node-pty (prebuilt binary; falls back to a C/C++ build)

From this repo instead:

cd cli
npm install
npm link           # makes `busymote-agent` a global command

Use

busymote-agent login      # or just sign in to the Busymote desktop app — the CLI reuses it

Then from any project folder (that folder becomes the agent's working directory):

cd C:\path\to\your\project
busymote-agent -- claude
# or: busymote-agent -- codex

The agent command must be one you can already run in that terminal — if claude alone doesn't work, busymote-agent -- claude won't either.

Not installed globally? Run it by path instead: node C:\...\LocalRemote\cli\busymote-agent.mjs -- claude

Your agent runs exactly as normal in this terminal. Open /agents on the Busymote web app on your phone (signed in to the same account) to watch it, tap y/n on approval prompts, or type follow-up instructions.

Security

• The only thing that can write to the agent's stdin is a row your account inserts into agent_input — RLS blocks everyone else. There is no public link for control.
• Sign-in reuses the desktop app's credentials, or BUSYMOTE_EMAIL / BUSYMOTE_PASSWORD.

Run supabase/agent-remote.sql once in your Supabase project to create the tables.