VaporKnow who needs you.
See every agent, its model and context use in one place. A push notification tells you when one finishes or asks for something.
Self-hosted · coding agent workspace
Your agents.
Your machine.
Wherever you are.
Leave the desk without losing the thread. Follow Codex, Claude Code, and Hermes from your phone, approve what they ask, get a notification when they need you, and return to the same terminal.
VaporAgentSample sessions
3 agents 1 needs input
Portfolio refreshCodex · Working
38%Release notesClaude Code · Needs input
24%Library researchHermes · Working
16%From a quick check-into a full terminal ↗
Say yes from anywhere.
When Claude Code asks permission to run a command or edit a file, approve or deny it from your phone. Your desktop notification buttons keep working too.
Read it like a chat.
Each prompt and reply comes from the agent's own session log, with long replies folded down. Send a message or several images, or switch to the raw terminal.
Pick up where you left off.
Sessions live in tmux on your machine and survive a dropped phone connection. Reattach from your desktop when you want a full keyboard.
An interactive product tour
A few agents. One place to check in.
Fictional sessions, entirely in your browser. Filter the list, open an agent, answer a sample prompt, or add a demo session. Nothing connects to a terminal or launches real work.
Simulated output · no model requests
Designed around your tools
A small control plane.
A familiar terminal.
VaporAgent runs alongside your installed agent CLIs. Your projects stay on your Linux machine, and each managed session runs in tmux.
Portable mode has no desktop-environment requirement. Optional desktop discovery adds activity and context telemetry; optional 9router integration supplies a model catalog.
Phone or desktop browserHTTPS + WebSocket
Authenticated proxyYour identity provider
VaporAgent → tmux → your agent CLIYour Linux host · your project files
Run it yourself
From source to your first session.
Start with a local trial. Then add an authenticated HTTPS URL for your phone.
- Linux, Node.js 22+, npm, Git, tmux, and Python 3
- make and a C/C++ compiler for native dependencies
- An installed, authenticated Codex, Claude Code, or Hermes CLI
Agent accounts and subscriptions are separate. Portable mode needs no NFS, Kitty, Hyprland, Quickshell, or 9router.
Linux / terminal
git clone https://git.coolhole.net/aestheticjmack/VaporAgent.git
cd VaporAgent
bash scripts/setup.sh
VAPORAGENT_DEV_AUTH=1 npm startOpen http://127.0.0.1:9120, choose New agent, and select your installed CLI.
Development auth is for local use only. Turn it off and configure an authenticated HTTPS proxy before remote access.
Full installation & phone setup guide ↗Before you install
Will it tell me when an agent needs me?
Yes. Add the app to your Home Screen, tap the bell, and VaporAgent sends a push notification when an agent asks for approval or finishes working. Each session notifies at most once a minute, and never while you have it open. Tapping the notification opens that session. On iPhone this needs iOS 16.4 or later and the Home Screen app.
Can I approve Claude Code’s permission prompts from my phone?
Yes. With the optional permission hook, a waiting prompt appears on the session card and in the chat with Approve and Deny buttons. Without it, VaporAgent recognises Claude’s own terminal prompt and answers it with Yes or No keys.
Can I use it on my iPhone?
Yes. Open your authenticated HTTPS URL in Safari, sign in, and use Share → Add to Home Screen. The PWA requires a network connection. Login persistence depends on your proxy’s cookie settings.
Does it replace my agent subscriptions or CLI?
No. VaporAgent provides the workspace and terminal interface. Install and authenticate the agent CLIs you want to use; their model access and billing remain separate.
Is the demo connected to your homelab?
No. It runs only on sample data in your browser. The private instance and real sessions are never exposed through this page.
What should I know about access?
This is experimental, single-user software. Someone with app access can operate a terminal as its Linux user. Read the security guide before configuring remote access.
Can I modify and share it?
Yes. VaporAgent is free software under GNU GPLv3 or later. See the license for the terms; third-party dependencies retain their own licenses.