
`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]`

## Building a link

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](https://exe.dev/shell) and give them the exact
command to run there.
