phyra-research

Roamux — AI skill for Claude Code

AI community

Run AI coding agents on your own machines.

How to install Roamux

This entry records only its repository, not the path inside it, so there is no exact command to give. Open phyra-research/roamux and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Roamux does

Run AI coding agents on your own machines. Control them from anywhere.

Alternatives in AI

Axonhub — ⚡️ Open-source AI Gateway — Use any SDK to call 100+ LLMs 3.2k ★
Browserwing — BrowserWing turns your browser actions into MCP commands Or Claude Skill, allowing AI agents to control browse 1.2k ★
Agentrq — AgentRQ: Human-in-loop realtime conversational task manager for AI Agents 1.1k ★

README

roamux

**Run AI coding agents on your own machines. Control them from anywhere.**

Your computer stays the execution host — the agent, your repo, shell, files, git state, credentials, and model access never leave it. A phone or browser signs in and steers the agent live.

[Quick start](#quick-start) · [How it works](#how-it-works) · [Contributing](CONTRIBUTING.md) · [Architecture](docs/architecture.md)

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) ![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6) ![Runtime: Bun](https://img.shields.io/badge/runtime-Bun-black)

What it is

roamux is a **remote control plane for AI coding agents running on machines you own**. Install a small host daemon on any computer; it dials out to the cloud and lets your authenticated devices watch and steer its agents. From your phone you can:

see your connected machines and their live agent sessions,
start a new session (pick a machine, a project, and an agent) and send tasks,
watch activity stream in real time,
approve or deny the agent's permission requests,
stop a run, and review the files it changed.

**Your code never leaves your machine.** The cloud routes structured control messages and stores only metadata (labels and ids) — never your files, paths, credentials, or model keys.

Supported agents (bring your own): **[OpenCode](https://opencode.ai)**, **[Claude Code](https://claude.com/claude-code)**, and **Codex**. roamux does not implement its own agent — it drives yours through a swappable `HarnessAdapter`.

Prerequisites

roamux **drives an agent you already run locally** — it does not ship or proxy a model. So before you start, install and sign in to **one** of the supported agent CLIs on the machine you want to control (this is where your model access and auth live — nothing leaves the box):