← All docs

Suggest links

https://exe.dev/suggest?command=<urlencoded-command> opens a page in the exe.dev dashboard that shows a single lobby command, describes what it will do, and offers a Run button.

These links are designed for agents (and humans) to hand off actions that an agent cannot (and should not!) perform on the user's behalf.

What can be suggested

Only some lobby commands (and arguments) may be suggested; the list changes over time. Sample commands:

  • ls [name|pattern]
  • share port <vm> [port]
  • share set-public <vm>
  • share add <vm> <email|team> [--message='...']
  • share receive-email <vm> [on|off]

URL-encode the entire command string. For example:

  • https://exe.dev/suggest?command=share+set-public+mybox

Notes for agents

When presenting a suggest link, also describe in plain language what following it will do — which VM, and any side-effects ("makes mybox reachable to anyone on the internet, no login required"). The user should not be surprised after clicking.

If a command can't be suggested, point the user at https://exe.dev/shell and give them the exact command to run there.