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

Pi Agent VS OpenCode — Customization & Control Comparison — Pi v0.52+ vs OpenCode v1.1+ (Feb 2026) Thesis: Pi and OpenCode are both MIT-licensed, open-source, model-agnos 526 ★
Skillport — Bring Agent Skills to Any AI Agent and Coding Agent — via CLI or MCP 408 ★
Tastecode — Personal Harness - a beautiful, adaptive control panel for AI coding agents 292 ★

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):