@coder-relay/cli

Local relay for the Coder web app. Lets the in-browser AI agent execute shell commands on your machine, safely and on your terms.

Install & run (one command)

RELAY_TOKEN=xxxx npx @3ced/coder-relay

Get your RELAY_TOKEN in Coder → Settings → Connect an agent.

Help

npx @3ced/coder-relay --help

How it works

The CLI polls your Coder app via two public endpoints:

• POST {url}/api/public/exec/poll — claims pending commands for your token.
• POST {url}/api/public/exec/result — streams back stdout/stderr/exit code.

Both require the header x-relay-token: <your token>. The token only authorizes the relay you generated; nothing else can talk to your machine.

Flags

| Flag | Env | Default | |-----------------------|-----------------|-------------------------------| | --token <t> | RELAY_TOKEN | — (required) | | --url <u> | RELAY_URL | https://coder.lovable.app | | --cwd <p> | RELAY_CWD | $PWD | | --poll-interval <ms>| POLL_MS | 1500 | | --once | — | poll once, exit (smoke test) | | --version / -v | — | | | --help / -h | — | |

Security

The relay runs shell commands with your user privileges. Only run a token you generated, on a machine you own. Revoke tokens any time from Settings.

License

MIT