Agent Studio Runner

Runner bridge for Agent Studio Mobile.

Codespaces

From a GitHub Codespace terminal, run:

npx --yes @lenoaskim-kor/agent-studio-runner@latest codespace

The direct forwarded-port flow is useful for local development, but production mobile access should use GitHub-authenticated port access or Agent Studio Relay so users can keep Codespaces ports private.

Codespaces through Agent Studio Relay

For the simplest mobile test, run one command in the Codespace terminal:

npx --yes @lenoaskim-kor/agent-studio-runner@latest director

It starts both the Relay and the Codespace runner, then prints the Relay URL, Relay token, and runner ID to enter in Agent Studio Mobile. For the MVP test runner, it also tries to make the Codespaces Relay port public automatically. If that fails, open the Codespaces Ports tab and set port 48731 visibility to Public. CLI sessions run through a tmux mirror when tmux is available. If a mobile approval menu is hard to read, run the tmux attach -t ... command printed by the runner in the Codespace terminal. In Director mode, Relay token is reused from .agent-studio/director-relay-token unless AGENT_STUDIO_RELAY_TOKEN is set. Keep .agent-studio/ out of Git.

The older codespace-relay command is kept as a compatibility alias for the same personal Director relay flow.

Experimental: short-code broker

Director mode does not require a broker. For a personal, non-commercial Director's Cut setup, use the director command above and reuse the saved token.

The broker command is kept only as an experiment for hiding Relay URL/token entry behind a short code:

Codespace runner registers Relay connection info with a broker
Broker returns a short one-time code
Mobile app resolves that code into Relay connection info

Start a broker you control:

AGENT_STUDIO_BROKER_TOKEN=replace-with-long-random-token \
npx --yes @lenoaskim-kor/agent-studio-runner@latest broker

Then run Director mode in Codespaces with the broker URL:

AGENT_STUDIO_BROKER_URL=https://broker.example.com \
AGENT_STUDIO_BROKER_TOKEN=replace-with-long-random-token \
npx --yes @lenoaskim-kor/agent-studio-runner@latest director

The broker stores Relay URL, Relay token, and runner ID only until the short code is resolved or expires. Do not use it for the normal personal Director path, and do not expose it publicly without HTTPS, auth, persistence, rate limiting, and revocation.

Advanced: connect to an existing Relay

Set the Relay URL, Relay token, and runner ID before starting the runner:

AGENT_STUDIO_RELAY_URL=https://relay.example.com \
AGENT_STUDIO_RELAY_TOKEN=replace-with-relay-token \
AGENT_STUDIO_RUNNER_ID=mobile-codespace \
npx --yes @lenoaskim-kor/agent-studio-runner@latest codespace

Keep the terminal open while checking the runner.