arial-cli

Command-line interface for Arial — dispatch coding jobs from your terminal.

Installation

npm install -g arial-cli

Authentication

Get an API token from your Arial dashboard (Dashboard → Keys), then authenticate:

arial login --token ak_your_token_here

This saves your credentials to ~/.arial/config.json.

Commands

dispatch

Dispatch a coding job to a repository:

arial dispatch owner/repo "Add a logout button to the navbar"

Read the prompt from a file:

arial dispatch owner/repo -f task.md

Options:

• -f, --file <path> — Read prompt from a file
• --strategy <strategy> — Execution strategy (cruise or glide, default: cruise)
• --json — Output as JSON

jobs

List recent jobs:

arial jobs

Inspect a specific job:

arial jobs <job-id>

Stream logs from a running job:

arial jobs <job-id> --logs

Cancel a job:

arial jobs <job-id> --cancel

Options:

• --logs — Stream job logs
• --cancel — Cancel the job
• --stop — Soft stop a running job
• --json — Output as JSON

repos

List connected GitHub repositories:

arial repos

Options:

• --json — Output as JSON

status

Show usage and job status overview:

arial status

Options:

• --json — Output as JSON

usage

Show detailed usage statistics for the current billing period:

arial usage

Options:

• --json — Output as JSON

Configuration

Configuration is stored in ~/.arial/config.json:

{
  "apiToken": "ak_...",
  "apiUrl": "https://api.arial.sh"
}

You can override the API URL during login:

arial login --token ak_... --api-url https://custom-api.example.com

License

MIT