Every asd command, grouped by topic, with a beginner's Top 7 above the list. asd ships ~230 commands across ~40 groups; you'll learn 7 of them on day one and pick the rest up as needed.
asd help (or asd actions for an interactive palette) gives you the
authoritative list inside the binary. This page is the wiki version:
same surface, with a "first commands" panel, an "I want to…" recipe
table, and groupings that let you scan for what you need.
For a beginner's deep-dive on the most-used commands — with examples,
expected output, and the failure mode you'll hit first — see
cli/starter.
¶ Top 7 — the commands you'll learn first
| # |
Command |
What it does |
| 1 |
asd help |
List every command (also asd actions for an interactive palette) |
| 2 |
asd init |
Scaffold asd.yaml + .env for a new project |
| 3 |
asd up |
Start the workspace — runs the up automation task in asd.yaml |
| 4 |
asd services |
Dashboard: process, tunnel, web URL, local URL per service |
| 5 |
asd urls |
Show the active workspace URLs (Caddy + tunnel + direct) |
| 6 |
asd expose <port> |
One-shot: tunnel localhost:<port> to a public HTTPS URL |
| 7 |
asd doctor |
System-wide health check (Docker, Caddy, env drift, stale clones) |
Each of these gets a full walk-through in cli/starter.
| Goal |
Command |
| …start a fresh project |
asd init then edit asd.yaml |
…start everything (defined in asd.yaml) |
asd up |
| …stop everything |
asd down |
| …see what's currently running |
asd services |
| …see active URLs |
asd urls |
…expose localhost:3000 without a manifest |
asd expose 3000 |
| …diagnose why something is off |
asd doctor |
| …apply the network state (routes + tunnels) |
asd net apply |
| …see what the manifests say (no apply) |
asd net discover |
| …kill all public tunnels |
asd net expose reset |
| …check who I am to the tunnel server |
asd auth whoami |
| …get login credentials for a basicauth service |
asd expose auth or asd net credentials |
| …open an in-browser terminal |
asd terminal start (or asd ttyd start) |
| …open an in-browser VS Code |
asd code start |
| …register a new project directory |
asd projects add . |
| …update asd itself |
asd update |
| …stash secrets locally |
asd vault set <key> |
asd organises commands into topical groups. Within a group, run
asd <group> for the subcommand list, or use the per-command lines
below.
| Group |
Key commands |
Purpose |
core |
asd up, asd down, asd init, asd setup, asd services, asd urls, asd doctor, asd cleanup, asd discover, asd logs, asd update |
The verbs that bring the workspace up, down, and out of trouble. Many core commands are also top-level shortcuts (you type asd up, not asd core up). |
down |
asd down list |
List tasks with pending teardown manifests. |
doctor |
asd doctor logs, asd doctor logs clear |
Persistent diagnostics log. |
env |
asd env init, asd env apply, asd env sync |
.env lifecycle: scaffold from templates, render per mode, merge upstream updates. |
mode |
asd mode list / set / show |
Project-level mode switching (dev/prod/staging/…). Drives env apply. |
service |
asd service add / list / remove |
Edit asd.yaml's service list. |
config |
asd config get / set / show / edit / validate / path / reset |
Read/write global asd config. |
| Group |
Key commands |
Purpose |
net |
asd net apply, asd net discover, asd net plan, asd net verify, asd net urls, asd net expose start/stop/reset, asd net caddy add/remove, asd net reset, asd net clean |
Manifest-driven networking — the heart of the system. |
expose |
asd expose <port> (top-level), asd expose list / stop / auth / cleanup |
Zero-config public exposure of a single port. |
caddy |
asd caddy start / stop / restart, asd caddy routes, asd caddy clear-routes, asd caddy config / list, asd caddy server-add, asd caddy sync-auth |
Direct control of the reverse proxy. Stateful — see internals/caddy-state. |
manifest |
asd manifest routes |
Run the manifest → routes pipeline (rarely needed directly). |
share |
asd share start / stop |
Sharing server (tunnel hub). |
| Group |
Key commands |
Purpose |
auth |
asd auth status / whoami / refresh / credentials / switch / export |
Identity and tokens. |
login |
asd login, asd login key |
OAuth login + headless API-key login. |
key |
asd key list / create / attach / remove |
Tunnel authentication keys. |
token |
asd token list / create / verify / use |
Ephemeral tunnel tokens. |
tunnel |
asd tunnel server start / stop / verify, asd tunnel identity / register / version |
Server-side (run your own tunnel server). |
server |
asd server list / set / info |
Pick which tunnel server you talk to. |
vault |
asd vault set / get / list / delete / export / import / migrate / inject / run / keys |
Local secret storage. |
ssh |
asd ssh connect / disconnect |
SSH to the tunnel server. |
| Group |
Key commands |
Purpose |
code |
asd code start [tunnel] / stop / tunnel |
Code-server (in-browser VS Code) launcher. |
codeserver |
asd codeserver start [tunnel] / stop |
Underlying code-server module. |
terminal |
asd terminal start [tunnel] / stop / tunnel |
Web terminal launcher. |
ttyd |
asd ttyd start [tunnel] / stop |
Underlying ttyd module. |
database |
asd database start / stop |
DbGate launcher. |
dbgate |
asd dbgate start / stop |
Underlying DbGate module. |
inspect |
asd inspect start / stop |
Network inspector (mitmproxy front-end). |
mitmproxy |
asd mitmproxy start / stop |
Underlying mitmproxy module. |
| Group |
Key commands |
Purpose |
automation |
asd automation run / yaml |
Run YAML automation files. |
schema |
asd schema automation |
Print automation YAML schema. |
data |
asd data push / pull / list / get / put / delete / gc / usage / cache clear |
Workspace snapshot push/pull + asset registry. |
made |
asd made start / status / refresh |
MADE session manager (sessions + dashboard). |
sandbox |
(subcommands) |
Docker-based sandbox environments. |
supabase |
asd supabase bootstrap / extract / start / stop |
Supabase local dev stack helper. |
| Group |
Key commands |
Purpose |
gh |
asd gh login / setup / list / runs / terminal / active / stop |
GitHub CLI + workflow trigger integration. |
glab |
asd glab setup / terminal |
GitLab integration (preview). |
repo |
asd repo setup |
Per-repo setup hooks. |
devinci |
asd devinci install |
Install CI workflow template. |
plugin |
asd plugin info |
Show plugin services and overlay examples. |
angular |
asd angular env / preflight |
Angular project helpers. |
skill |
asd skill install / list / status |
ASD skills for AI assistants. |
| Group |
Key commands |
Purpose |
projects |
asd projects add / remove / default / list / current / detect / prune |
Project registry. |
deps |
asd deps check / install / list / sync / update / validate |
Managed binary dependencies (caddy, ttyd, …). |
update |
asd update check / list / version |
asd self-update status. |
ac |
asd ac install / refresh / remove / status |
Shell autocompletion. |
bash |
(Windows-only) asd bash list / set / status / test / install-busybox / reset |
Pick which bash asd uses on Windows. |
tmux |
asd tmux install / version / which / snapshot |
tmux helper (TUI regression testing). |
logs |
asd logs list / clear |
Log file management. |
asd help is the canonical list. Run it whenever you suspect
this page is stale. The output is grouped the same way (📦 per group)
and prints a Total: N commands line at the bottom.CI=true asd … forces non-interactive output. Use in scripts,
log captures, and anywhere you don't want the TUI to take over.- Top-level shortcuts — many
core commands are reachable as
bare verbs (asd up, asd down, asd doctor, asd urls, asd expose)
and as asd core <command>. Both work; the short form is what
you'll see most often.
- Group-only invocations (
asd net, asd caddy, asd auth with
no subcommand) typically print the subcommand list or open an
interactive TUI. Use CI=true to force the listing.