Feature Maturity
Overview
ASD CLI includes features at different stages of development. This page helps you understand which capabilities are battle-tested and recommended for daily use, and which are still experimental. Use this information to make informed decisions about which features to adopt in your workflow.
Maturity Levels
Every feature is assigned one of five maturity levels:
| Level | Symbol | What It Means |
|---|---|---|
| Production | ✅ | Battle-tested with full test coverage. Recommended for all users. |
| Stable | 🟢 | Works reliably with good test coverage. Safe to depend on. |
| Beta | 🟡 | Functional but may have rough edges. Suitable for non-critical workflows. |
| Alpha | 🟠 | Early implementation. Not recommended for production use. API may change. |
| Planned | ⏳ | Documented or designed but not yet implemented. |
Features graduate through these levels as they gain test coverage, real-world usage, and stability. See Feature Graduation Path at the bottom of this page for how features advance.
Core Features
These are the foundational capabilities of ASD CLI.
| Feature | Status | Description |
|---|---|---|
asd init | ✅ Production | Full workspace setup, binary installation, and project detection |
asd net (TUI) | ✅ Production | Interactive service management dashboard with health checks |
asd net apply | ✅ Production | Apply network configuration for Caddy and tunnel setup |
asd.yaml config | ✅ Production | Schema-validated project configuration with service definitions |
| Health checks | ✅ Production | Multi-level cascade: tunnel, HTTP, TCP, and process checks |
| Service registry | ✅ Production | JSON-based state management with upsert/remove operations |
| Dynamic port allocation | ✅ Production | Automatic conflict-free port assignment, persisted to .env |
All core features are production-ready and extensively tested across platforms.
Tunneling and Exposure
These features handle sharing local services over HTTPS tunnels.
| Feature | Status | Description |
|---|---|---|
asd expose <port> | 🟢 Stable | Quick one-command exposure with Caddy proxy and tunnel |
asd auth status | 🟡 Beta | Check credential and authentication status |
asd net expose start/stop | 🟢 Stable | Per-service tunnel lifecycle control |
| Public HTTPS tunnels | 🟢 Stable | Subdomain-based public URLs via the ASD tunnel network |
| Tunnel modes (caddy/direct) | 🟡 Beta | Switch between proxied and direct tunnel connections |
Tunnel access is included with all paid subscription plans. Ephemeral 5-minute tunnels are available without an account for quick testing.
Built-in Services
ASD bundles several developer tools that can be started with a single command.
| Service | Command | Status | Description |
|---|---|---|---|
| Caddy Proxy | asd caddy | ✅ Production | Local reverse proxy with host/path routing and TLS |
| VS Code Server | asd code | 🟢 Stable | Browser-based VS Code with extension support |
| Web Terminal | asd terminal | 🟢 Stable | ttyd-based shell access from any browser |
| Database UI | asd database | 🟢 Stable | DbGate graphical interface for database management |
| Network Inspector | asd inspect | 🟠 Alpha | mitmproxy-based traffic inspection (see note below) |
Note on Network Inspector
The network inspector is currently in Alpha and operates as a standalone service only. What works today:
- Starting and stopping the mitmproxy web UI
- Service registration in the
asd netdashboard - Web UI access at
http://localhost:<port>/ - Password protection via
ASD_BASIC_AUTH_PASSWORD
What is not yet implemented:
- Automatic traffic routing through the proxy
- TUI integration for per-service “Inspect Traffic” actions
- Caddy proxy chaining for transparent interception
To use the inspector today, manually configure your application to use localhost:8080 as its HTTP proxy.
Vault — Secret Management
ASD Vault provides encrypted secret storage backed by Supabase Vault (pgsodium). All vault features are currently in Alpha.
| Feature | Status | Description |
|---|---|---|
asd vault set/get/delete | 🟠 Alpha | Core CRUD for encrypted secrets |
asd vault list | 🟠 Alpha | List secret metadata (names, categories — no values) |
asd vault import/export | 🟠 Alpha | Bulk directory-based secret import and export |
asd vault inject | 🟠 Alpha | Template substitution using asd:// references |
asd vault run | 🟠 Alpha | Run processes with secrets injected as environment variables |
| Personal and org scopes | 🟠 Alpha | Per-user secrets and shared organisation secrets |
| Web dashboard | 🟠 Alpha | View metadata at /workspace/vault/ in the admin panel |
| Plan-based quotas | 🟠 Alpha | Secret limits by plan (Developer: 10, Pro: 50, Scale: 200) |
Vault requires authentication via asd login. CLI flags and API contracts may change between releases during the Alpha phase. Secret limits vary by subscription plan — see subscription details for included quotas, or purchase the Vault addon for additional capacity.
GitHub Integration
Integrate ASD with GitHub Actions for remote terminal access and workflow automation.
| Feature | Status | Description |
|---|---|---|
asd gh setup | 🟡 Beta | Install ASD GitHub Actions workflows into your repository |
asd gh terminal | 🟡 Beta | Open a remote terminal session via GitHub Actions |
asd gh list/runs | 🟡 Beta | List and inspect GitHub Actions workflow runs |
These features require a GitHub repository and appropriate permissions. See the GitHub Integration section in the CLI reference for details.
Project Management
| Feature | Status | Description |
|---|---|---|
| Multi-project registry | 🟡 Beta | Switch between projects, set defaults |
| Plugin system | 🟠 Alpha | Extensible service discovery (only Supabase plugin shipped) |
| Supabase plugin | 🟡 Beta | Bootstrap, start/stop, and credential extraction for Supabase |
Platform Support
ASD CLI is cross-platform. The table below reflects current testing and support status.
| Platform | Status | Notes |
|---|---|---|
| Linux (x64) | 🟡 Beta | Primary development platform, tested in CI |
| Linux (ARM64) | 🟡 Beta | Verified via Docker + QEMU emulation |
| macOS (x64 and Apple Silicon) | 🟠 Alpha | Tested in CI, native ARM support |
| Windows (x64) | 🟡 Beta | Binary works well; some edge cases with path handling |
| Android (Termux / ARM64) | 🟠 Alpha | All binaries verified; rough edges remain |
Windows recommendations: Git Bash provides the best experience and matches the documentation examples. Windows Terminal with PowerShell and CMD.exe are also tested and functional.
Android: ASD runs on Android via Termux. All binaries (Caddy, ttyd, DbGate, mitmproxy) install and operate correctly on ARM64.
Feature Graduation Path
Features progress through maturity levels as they meet specific criteria:
Alpha to Beta
- Basic functionality is complete and working
- Some automated test coverage exists
- Documentation describes usage and known limitations
Beta to Stable
- Good automated test coverage across supported platforms
- User-facing documentation is comprehensive
- No known major bugs or data-loss scenarios
- API and CLI surface are settling (breaking changes are rare)
Stable to Production
- Full test coverage including edge cases
- Battle-tested by real users in real workflows
- Recommended for all users without caveats
- Breaking changes require a major version bump
Testing Infrastructure
ASD CLI is backed by a thorough testing pipeline:
- Unit tests: 1,000+ passing tests covering schemas, functions, and configurations
- Integration tests: YAML-based automation runner for end-to-end CLI workflows
- Cross-platform CI: GitHub Actions matrix across Ubuntu, macOS, and Windows
- Docker tests: Isolated, reproducible test environment for consistent results
Related Guides
- Getting Started — Set up ASD and create your first tunnel
- CLI Command Reference — Full reference for all ASD commands including
asd expose - Built-in Services — Web terminal, VS Code server, database UI, and network inspector
- Understanding Tunnels — How HTTPS tunnels work and tunnel lifetime