a4-cli

Command-line tool for building, deploying, and managing Arete stream stacks.

Installation

cargo install a4-cli

From Source

git clone https://github.com/AreteA4/arete.git
cd arete
cargo install --path cli

Quick Start

# Initialize project (auto-discovers AST files)
a4 init

# Authenticate
a4 auth login

# Deploy
a4 up

That's it! Your stack is deployed and you'll see the WebSocket URL.

Command Overview

Daily Workflow

# Make changes to your stack, rebuild
cargo build

# Deploy
a4 up

# Check status
a4 status

Stack Commands

a4 stack list

List all stacks with deployment status:

STACK              STATUS     VERSION  URL
settlement-game    active     v3       wss://settlement-game.stack.arete.run
token-tracker      active     v1       wss://token-tracker.stack.arete.run

a4 stack show <name>

Show detailed information:

a4 stack show settlement-game

Shows: entity info, deployment status, version history, recent builds.

a4 stack push [name]

Push local stacks to remote without deploying:

a4 stack push                  # Push all
a4 stack push settlement-game  # Push one

a4 stack versions <name>

Show version history:

a4 stack versions settlement-game --limit 10

a4 stack rollback <name>

Rollback to a previous version:

a4 stack rollback settlement-game          # Previous version
a4 stack rollback settlement-game --to 2   # Specific version

a4 stack delete <name>

Delete a stack:

a4 stack delete settlement-game

Deployment

a4 up [stack-name]

The happy path - push, build, and deploy in one command:

a4 up                              # Deploy all
a4 up settlement-game              # Deploy one
a4 up settlement-game --branch staging  # Branch deploy
a4 up settlement-game --preview    # Preview deployment

Authentication

a4 auth register    # Create new account
a4 auth login       # Login
a4 auth logout      # Logout
a4 auth whoami      # Verify with server

Credentials: ~/.arete/credentials.toml

SDK Generation

a4 sdk list                                   # List available stacks
a4 sdk create typescript settlement-game      # Generate TypeScript SDK
a4 sdk create rust settlement-game            # Generate Rust SDK
a4 sdk create typescript ore-stack-abc123     # Generate from a hosted stack identifier

Configuration

File: arete.toml

[project]
name = "my-project"

[sdk]
output_dir = "./generated"

# Stacks - auto-discovered from .arete/*.stack.json
# `stack` may be a local AST name/path or a hosted stack identifier.
[[stacks]]
name = "my-game"
stack = "SettlementGame"

For most projects, you only need:

[project]
name = "my-project"

The CLI auto-discovers stacks from .arete/*.stack.json files.

WebSocket URLs

Environment Variables

Troubleshooting

License

Apache-2.0