The most-used asd command group. Reads net.manifest.yaml files, configures Caddy routes + tunnels, manages the registry.
net is where most of the day-to-day routing work happens. The
flagship verb is asd net apply — everything else either reads
state (discover, plan, verify) or surgically touches one
service (expose start/stop, start/stop, remove).
For the overview of every command group: cli/index.
For a Top-7 walkthrough: cli/starter.
¶ Commands
| Command |
What it does |
asd net apply |
Read every manifest, populate registry, regenerate Caddy routes, start tunnels. Idempotent. The workhorse. |
asd net plan |
Show what apply would do (diff against current state). No mutations. |
asd net discover |
Print what asd reads from manifests (JSON). Dry read. |
asd net actions |
List available actions for a given service. |
| Command |
What it does |
asd net start <id> |
Start a stopped service (from the registry). |
asd net stop <id> |
Stop a running service. |
asd net refresh |
Re-detect running services and update statuses. |
asd net remove <id> |
Remove a service from the registry. |
| Command |
What it does |
asd net expose start --id=<id> |
Start the public tunnel daemon for one service. |
asd net expose stop --id=<id> |
Stop one tunnel. |
asd net expose reset |
Force-recreate all tunnels (safe by default; --kill-ssh for legacy broad kill). |
| Command |
What it does |
asd net caddy add <id> |
Add the Caddy route for one service (subset of apply). |
asd net caddy remove <id> |
Remove one Caddy route. |
asd net reset |
Reset Caddy to default state — clear all routes (--preserve-tunnels / --unhealthy-only for selective). |
| Command |
What it does |
asd net verify |
Run health checks across all registered services. Returns non-zero on failure. CI-friendly. |
asd net clean |
Prune stale entries from the network registry. |
asd net urls |
Show active workspace URLs (Caddy + tunnel + direct). Same data as top-level asd urls. |
asd net credentials |
Copy a service's auth credentials to the clipboard. |
asd net open <id> |
Open a service's URL in the default browser. |
| Command |
What it does |
asd net pending |
List services asd has detected but not yet registered. |
asd net onboard <id> |
Register a detected service in the registry. |
asd net setup |
Interactive wizard for initial network setup. |
| Goal |
Command |
| Apply manifest changes |
asd net apply |
| Dry-run before applying |
asd net plan |
| See what asd thinks your manifests say |
asd net discover \| jq |
| Bring up the tunnel for one service after editing it |
asd net expose start --id=<id> |
| Kill all public tunnels |
asd net expose reset |
| CI-friendly health gate |
asd net verify |
| Re-detect new services running on the host |
asd net refresh |