CLI Installation

Option 1: Global install

bun add -g asactl

Verify:

asactl -h

Option 2: Install from source

git clone https://github.com/ASAHubAI/asactl.git
cd asactl
bun run install-local

For local link-based debugging:

bun link

Requirements

• Bun runtime is recommended
• A reachable ASAHub/OpenASA endpoint is required for remote commands

Optional Environment Variables

• ASACTL_SERVER_HOST
• ASACTL_USER_DIR
• ASACTL_WORKSPACE_DIR
• ASACTL_REMOTE_TIMEOUT_MS
• ASACTL_DEV
• ASACTL_INSECURE_TLS

Recommended first-time setting:

export ASACTL_SERVER_HOST=https://asahub.ai

Shell Completion

Generate completion files:

bun run scripts/generate-completion.ts

Then install the generated files under completions/ for your shell.