Ara CLI

Install Ara on your computer, sign in, and run approved work locally.
以 Markdown 格式查看

Ara CLI is the local control surface. It signs you in, connects your coding agents to Ara, and installs the native worker that can run approved work on your own machine.

Ara CLI is the setup and control surface, not a second chat UI. Conversation and session history stay in Ara Cloud. If you are looking for the agent-facing tool connection itself, that is Ara MCP.

Install

$curl -fsSL https://ara.so/install.sh | bash
$export PATH="$HOME/.local/bin:$PATH"

The installer places a signed binary at ~/.local/bin/ara.

Sign in

$ara login

Sign-in completes in the browser and binds the CLI to one workspace. The CLI keeps its own revocable grant, separate from the grants held by each coding client. You have 15 minutes to approve the request.

After you approve, the browser redirects to a local http://127.0.0.1:.../callback URL that hands the login back to your terminal. If that page cannot load — the browser is on another machine, or behind a proxy that cannot reach your loopback — copy the callback URL out of the address bar and paste it into the waiting ara login prompt to finish signing in. A callback URL only works in the ara login attempt that produced it; if the attempt has already exited, run ara login again.

Connect your coding agents

$ara mcp setup
$ara mcp status

This configures every supported client Ara detects and starts each one’s native OAuth flow. Use the command’s help output when you want to limit setup to specific detected clients. What each client receives, and which tools the connection exposes, is covered in Ara MCP.

Run work on this Mac

$ara device

Bare ara device installs or repairs this Mac as a background Ara Device, and is idempotent: running it again on the same version changes nothing. The signed worker updates its own managed runtime, health-checks the active release, and rolls back a failed activation.

Ara Device is an execution target for a session, not a separate product. You start the session in Ara Cloud and choose this Mac as where it runs. Approved file and shell operations execute locally; the transcript stays in Ara Cloud.

To connect a Mac from the web app instead, open Workspace → Devices, choose Copy Ara CLI setup on the Add a Mac card, and complete the browser approval.

Keys for CI

Interactive coding agents should use OAuth. For unattended CI or headless jobs, create a scoped ara_ API key and store it in that job’s secret manager. See the API quickstart.