index.md

Getting Started

A.R.C. CLI is a powerful, zero-dependency Go CLI for managing and orchestrating AI agent infrastructure.

Installation

Quick Install (Recommended)

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/arc-framework/arc-cli/main/install.sh | bash

Windows (PowerShell as Administrator):

irm https://raw.githubusercontent.com/arc-framework/arc-cli/main/install.ps1 | iex

Manual Installation

1. Download from Releases
2. Extract and move to your PATH:

   tar -xzf arc-cli_*.tar.gz
   sudo mv arc /usr/local/bin/

3. Verify: arc --version

First Commands

# See available commands
arc --help

# Check version
arc --version

# View system information
arc info

Initialize a Workspace

# Create a new A.R.C. workspace
arc workspace init

# Or specify a path
arc workspace init ./my-project

This creates:

my-project/
├── arc.yaml          # Workspace manifest (source of truth)
├── .env              # Environment variables
└── .arc/             # System state and generated configs

Configure and Run

Edit arc.yaml to enable features:

version: "1.0.0"

features:
  voice: true         # Voice AI capabilities
  security: true      # Authentication & authorization
  observability: true # Metrics, logs, traces

Then launch:

arc workspace run

Customize Your CLI

# List available themes
arc theme list

# Set a theme
arc theme set rainbow

# Preview current theme
arc theme show

Next Steps

• Workspace Guide - Deep dive into workspace configuration
• Service Catalog - All 29 platform services