Skip to content

About

Control your computer from your phone's browser: terminals, Claude Code and Codex chats, Git, files and open apps. Runs on your own machine, nothing to install on the phone, no cloud account.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Pocket Dev

Short demo of Pocket Dev on a phone: a live terminal, a Claude Code chat and switching between computers (demo data)

Control your computer from your phone's browser: terminals, Claude Code and Codex chats, Git, files and open apps. Runs on your own machine, nothing to install on the phone, no cloud account.

npm Node 22+ macOS, Windows, Linux

Features

  • Terminals on your computer that keep running when you close the page, with a compact key bar for phone keyboards and a strip that shows Claude Code's helper agents.
  • Chat with Claude Code and Codex using your own logins, plus Antigravity and GitHub Copilot (experimental). Approval cards, permission modes and a message queue work from the phone.
  • Switch the provider and the model in the same chat. The whole conversation goes with you.
  • One Chats list, newest first: your Pocket Dev chats and the Claude Code, Codex, Antigravity and Copilot conversations on your computer, together.
  • Continue between computer and phone. Open a computer conversation to read along live; send a message to continue it on the phone. Continue on computer takes it back.
  • Copy any chat message with the icon under it, and see when each message was sent.
  • Files: browse, upload (with Take photo on phones), download and zip. PDFs and text files open from Files and Messages.
  • Git: see changes, commit and push.
  • Messages between your devices, with photos, videos and documents.
  • Open apps, health and power: see open apps, battery, CPU and temperature, and sleep or shut down.
  • Several computers, one phone (rooms), with per-device permissions.
  • Share one project with someone for 1 hour, 1 day or 7 days through a QR invitation.
  • Internet access through a Cloudflare Tunnel: optional, off by default.
  • Admin page with a Dock, Start menu or app menu tile, and self-update (pocket-dev update or the Admin Update button).
  • Private by design: runs on your own computer as your user, logs in with a password or a one-time QR code, needs no cloud account and nothing installed on the phone.
  • Set up with AI: copyable prompts for your coding assistant, an agent setup guide and a reusable agent skill.

What's new in 2.1

  • New in 2.1.2: a copy icon under every chat message, the time on every message, documents (PDF and text) that open from Messages and Files, and a tidier code layout.
  • One Chats list, newest first. Your Pocket Dev chats and recent computer conversations are mixed by when each was last active, so the conversation you are having on your computer right now sits at the top. The list refreshes by itself while open.
  • Read along, then continue. Opening a conversation that is still open on your computer no longer closes it there. You can read along live. Sending a message continues it on the phone and closes the computer's copy gently, so Claude Code exits cleanly instead of showing an error in VS Code. Stop takes over at once.
  • Windows hand-over: Pocket Dev finds and safely closes the program holding a conversation on Windows too.
  • Take photo in the paperclip and Upload menus opens the camera directly, and Files opens Android's document picker.
  • Set up with AI: copyable prompts, an agent setup guide and a reusable agent skill.

2.0 added four chat engines, provider and model switching in one chat, self-update and the Admin tile. Details: 2.1 release notes · 2.0 release notes.

Important

Important before you start

  • You need Node.js 22 or newer (node -v).
  • Your computer and phone must be on the same Wi-Fi.
  • Type the package name exactly: @anisirji/pocket-dev, with the @ and with -g.
  • Your computer may ask about the firewall. Allow it on Private networks.
  • A different npm package called pocket-dev can take over the command. If you see unknown command 'start' or EEXIST, run npm uninstall -g pocket-dev, then install again.
  • The first pocket-dev start opens a short guided setup. It asks before every change. Run it again any time with pocket-dev setup.
  • The install itself makes one change without asking: npm install -g adds a Pocket Dev Admin shortcut with the Pocket Dev logo: a Dock tile on macOS, Desktop and Start menu shortcuts on Windows, an applications menu entry on Linux. Undo it with pocket-dev admin unpin. Skip it with POCKET_DEV_NO_PIN=1 or npm install -g --ignore-scripts. npx and CI never add it.

Step by step for your system: Windows, macOS, Linux.

Quick start

You need Node.js 22 or newer (node -v to check) and a phone on the same Wi-Fi.

Want your coding assistant to set it up? Copy the AI setup prompt. Paste it into an assistant that can run commands on your own computer. The same page has a prompt for continuing your current project from your phone. Setup details for agents · Reusable agent skill.

npm install -g @anisirji/pocket-dev
pocket-dev start
  1. The first time, pocket-dev start opens the guided setup. It shows each command before it runs it and asks first. Claude Code, Codex, GitHub Copilot and the GitHub CLI are installed or logged in only if you say yes. The Always on step shows one list of recommended changes (start at login, Keep awake) and asks once.
  2. At the end it prints an address like http://192.168.1.25:7777 and a one-time QR code. If Pocket Dev now runs in the background, do not run pocket-dev start again. If you do, it says it is already running and prints a fresh QR code.
  3. On your phone, scan the QR code (or open the address and type the password).

Updating. The guided setup starts by checking for a newer version and asks Update now? [Y/n] (Enter means yes), so a new install is current from the first minute. Later, pocket-dev update does the same, and pocket-dev update --check only says whether one exists. When a newer version is on npm, the phone shows an update icon beside the Settings gear and a notice every time you open Pocket Dev, and the Admin page shows an Update button that installs it on the computer and restarts the background service. The computer also gets a desktop notification while an update is waiting (pocket-dev config set updateNotify false turns that off). Installing stays on the computer: the phone only tells you.

Privacy. The only thing Pocket Dev looks up online by itself is the newest version number: one plain request to the npm registry, at most every six hours, with nothing about you or your computer in it. Turn it off with pocket-dev config set updateCheck false or POCKET_DEV_NO_UPDATE_CHECK=1. Everything else stays on your computer, as before. 4. If your computer asks, allow Pocket Dev through the firewall.

The Admin page is one click away from the Dock, Start menu or applications menu (see the note above). pocket-dev admin pin --status shows where it is. A new login code any time: pocket-dev qr. The guide again: pocket-dev setup. Scripts and CI never get a question: without a terminal, pocket-dev start prints the status and the command, then starts. --no-setup (or POCKET_DEV_NO_SETUP=1) skips the guide.

Just trying it? npx -y @anisirji/pocket-dev start runs it once and installs nothing.

If something goes wrong

You see Do this
unknown command 'start'. See 'main --help' or EEXIST ... pocket-dev.cmd A different npm package, pocket-dev, owns the command. Run npm uninstall -g pocket-dev, then npm install -g @anisirji/pocket-dev again.
pocket-dev is not recognised after installing Close the terminal and open a new one.
Install fails on node-pty Run pocket-dev doctor --fix. On macOS run xcode-select --install first.
Version X is available (update icon on the phone, banner on the Admin page) Tap Update on the Admin page on your computer, or run pocket-dev update in a terminal there.
The phone cannot open the address Same Wi-Fi? Firewall allowed? Port busy? Run pocket-dev doctor.

More fixes: Troubleshooting.

Docs

Community and support

A little more freedom

I built Pocket Dev because I wanted us to spend less time tied to a desk and more time living, without losing touch with our work.

If it makes your day a little freer, share it with three people you’d love to see escape the PC cage too. If they find it useful, invite them to share it with three more.

No pressure. Just something useful, passed from one person to another. ❤️

Let your AI help you set it up

Made by anisirji. Licence: ISC. If you use or build on this code, keep the copyright notice in LICENSE and please credit and link theani.me.

About

Control your computer from your phone's browser: terminals, Claude Code and Codex chats, Git, files and open apps. Runs on your own machine, nothing to install on the phone, no cloud account.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages