# agents — remote console for coding agents

> Open-source (MIT), self-hosted console for driving coding agents that run on your own
> machines. From a phone you can watch every session across every machine, answer the
> agent, approve or deny the tool calls it wants to make, dispatch new tasks, and proxy a
> machine's local dev server into your browser.

Source: https://github.com/chaxus/agents

## What it is

- A **relay** you deploy yourself: one Cloudflare Worker plus one Durable Object. It hosts
  the web console, routes messages between phone and machines, and stores session history.
- A **CLI** you run once per machine. It dials *out* to the relay over WebSocket and embeds
  the Claude Agent SDK, so the machine needs no public IP, no open port, no VPN and no
  tunnel software.
- A **web console** (PWA, installable) that is the only user interface.

## What it is not

- Not a hosted service — there is nothing to sign up for; you hold the key and the deployment.
- Not multi-user — authentication is a single shared key, `AGENTS_KEY`, which is also the
  identity. Anyone with the key sees every machine and session.
- Not a replacement for Claude Code — it drives an existing, already signed-in installation.

## Requirements

- Node.js 23+ on each machine you want to reach.
- A Cloudflare account (the free plan is enough for personal use).
- Claude Code installed and signed in on those machines.

## Setup

```
# relay, once
pnpm install && cd apps/relay-cf
npx wrangler login
pnpm deploy
npx wrangler secret put AGENTS_KEY

# every machine you want to reach
pnpm --filter agents-cli start
```

## Safety

It lets a remote agent run commands and change files on your computer. Deploy it with the
care you would give an exposed SSH port. The CLI allows read-only tools by default;
anything that writes or executes waits for approval in the browser.
See https://github.com/chaxus/agents/blob/main/SECURITY.md

## Docs

- README: https://github.com/chaxus/agents/blob/main/README.md
- Contributor/agent conventions: https://github.com/chaxus/agents/blob/main/AGENTS.md
- Relay: https://github.com/chaxus/agents/blob/main/apps/relay-cf/README.md
- Device CLI: https://github.com/chaxus/agents/blob/main/apps/cli/README.md