Runners

You can start Amp threads remotely from ampcode.com on any machine where you can run amp.

To do that, you need an Amp instance that serves as a runner.

Start a Runner

Run amp --no-tui to start a runner-only Amp instance. It waits for and runs remotely created threads in the current directory without opening the TUI.

Pass --runner-id <id> to give it a stable runner ID:

$ amp --no-tui --runner-id grandmas-garage-server

Runner IDs must be valid hostnames and are case-insensitive. Amp preserves the casing you provide.

To access the runner’s terminals from ampcode.com, pass --remote-control-terminal:

$ amp --no-tui --runner-id grandmas-garage-server --remote-control-terminal

TUI as Runner

You can turn every interactive Amp TUI into a runner too by adding this setting:

// ~/.config/amp/settings.json

{
	"amp.remoteThreadCreation.enabled": true
}

You can also use the command amp: enable remote creation of threads to turn it on. Each TUI accepts new threads in the directory where you started it.