The top-level "go", "stop", "look", "fix" commands. Most live under the core group internally; you type them as bare verbs (asd up, asd down, asd doctor, …).
These are the commands you reach for first when running, restarting,
or debugging a project. They're top-level shortcuts to subcommands
in the core group of asd help.
| Command |
What it does |
asd up |
Run the automation.up task in asd.yaml. The "go" verb. Flags: --task=<name>, --env=<file>, --dev, --prod. |
asd down |
Run the automation.down task (or replay one task's onDown steps). asd down list shows pending teardown manifests. |
asd start |
Run automation.start (a different task than automation.up if both are defined). |
asd stop |
Run automation.stop. |
asd run <task> |
Run any named task from automation.<task> — asd up and asd start are sugar for this. |
| Command |
What it does |
asd (bare) |
Open the services dashboard. CI=true asd for non-interactive. |
asd services |
Same as bare asd. Use the explicit form in scripts. |
asd urls |
Active workspace URLs (Caddy + tunnel + direct) from the registry. |
asd logs |
Aggregated logs from every running service. |
asd registry |
View or manipulate the service registry directly (advanced). |
| Command |
What it does |
asd init |
Scaffold asd.yaml + .env + .gitignore in the current directory. (Alias for asd setup.) |
asd setup |
Same as asd init. |
asd discover |
Discover services by running your dev command. Used during initial setup to find what ports your app binds to. |
| Command |
What it does |
asd doctor |
System-wide health check: Docker, Caddy, env drift, stale clones, restarting containers. Exits non-zero on ❌. |
asd diagnose |
Diagnose tunnel connection issues specifically. |
¶ Maintenance
| Command |
What it does |
asd cleanup |
Purge workspace logs and test artefacts (frees disk). |
asd update |
Self-update the asd CLI to the latest version. |
asd test |
Run integration tests (usage: asd test [module] [--filter pattern]). |
| Command |
What it does |
asd actions |
Open the command palette — interactive fuzzy-search across every asd command. |
asd docs |
Interactive documentation browser (TUI). |
asd code |
Interactive VS Code server access menu. |
asd database |
Interactive database manager (DbGate) menu. |
asd terminal |
Interactive web-terminal menu. |
asd inspect |
Interactive network inspector (mitmproxy) menu. |
| Command |
What it does |
asd help |
List every command. Authoritative. |
asd login / asd logout |
OAuth login / logout for the tunnel server. |
asd read-env |
Print values from the active .env file. |
asd key |
List local tunnel authentication keys (top-level alias for asd key list). |
asd token |
List local tunnel tokens (top-level alias for asd token list). |
asd server |
Interactive tunnel-server picker (alias for asd server set). |
asd net |
Open the interactive network services TUI (alias for the net group's TUI). |
These seven cover ~95% of day-to-day use:
asd help — list commandsasd init — scaffold a projectasd up — start the workspaceasd services — see what's runningasd urls — the active URLsasd doctor — diagnoseasd down — stop everything
Each one is covered in detail in cli/starter.