VaporAgent← Jacob McKenzie’s portfolio

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, answer when they need you, and return to the same terminal.

Try the demo Run it yourself

Linux + Node.js + tmux · GNU GPLv3-or-later

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 ↗
01 / FOLLOW

Know who needs you.

See working agents and pending input in one place. Search sessions and filter out the noise.

02 / RESPOND

Keep the work moving.

Read terminal output, send a message or an image, and use the raw terminal for interactive prompts.

03 / RETURN

Pick up where you left off.

Persistent tmux sessions stay on your machine. 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.

Add a demo agent

This adds a fictional session to the tour.

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 start

Open 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

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.

Your next check-in can happen anywhere.

Get the source ↗Explore the demo