Arial CLI — dispatch coding jobs from your terminal
npm install arial-cliCommand-line interface for Arial — dispatch coding jobs from your terminal.
``bash`
npm install -g arial-cli
Get an API token from your Arial dashboard (Dashboard → Keys), then authenticate:
`bash`
arial login --token ak_your_token_here
This saves your credentials to ~/.arial/config.json.
Dispatch a coding job to a repository:
`bash`
arial dispatch owner/repo "Add a logout button to the navbar"
Read the prompt from a file:
`bash`
arial dispatch owner/repo -f task.md
Options:
- -f, --file — Read prompt from a file--strategy
- — Execution strategy (cruise or glide, default: cruise)--json
- — Output as JSON
List recent jobs:
`bash`
arial jobs
Inspect a specific job:
`bash`
arial jobs
Stream logs from a running job:
`bash`
arial jobs
Cancel a job:
`bash`
arial jobs
Options:
- --logs — Stream job logs--cancel
- — Cancel the job--stop
- — Soft stop a running job--json
- — Output as JSON
List connected GitHub repositories:
`bash`
arial repos
Options:
- --json — Output as JSON
Show usage and job status overview:
`bash`
arial status
Options:
- --json — Output as JSON
Show detailed usage statistics for the current billing period:
`bash`
arial usage
Options:
- --json — Output as JSON
Configuration is stored in ~/.arial/config.json:
`json`
{
"apiToken": "ak_...",
"apiUrl": "https://api.arial.sh"
}
You can override the API URL during login:
`bash``
arial login --token ak_... --api-url https://custom-api.example.com
MIT