# Ara

> Ara is an autonomous software engineer for GitHub. Connect a repository, assign
> issues, and Ara's cloud agents open evidence-backed pull requests (with screen
> recordings, logs, and review-ready diffs). Ara is built to be operated by AI
> agents as well as people: it ships a headless public CLI and a per-user HTTP
> API so an agent can drive the whole product without a browser.

If you are an AI agent: prefer the `ara` CLI and the HTTP API below over scraping
this website. The CLI is the agent-first interface. If you can run a shell,
install it and use it.

## Install the CLI (recommended for agents)

```bash
curl -fsSL https://ara.so/install | sh   # self-contained binary, no Node/Bun needed
ara auth:login                           # browser sign-in; stores a refreshing session
ara help                                 # full command list
```

`ara` is a per-user HTTP client over the public API. Every command maps to one
API route and sends your personal access token as a Bearer header. It has no
service-role access and cannot act as another user. Override the target with
`--api-url` / `ARA_API_URL`; pass a token directly with `--token` / `ARA_API_TOKEN`
for headless/CI use instead of the browser login.

## Common commands

```bash
ara repos:connected                          # repos reachable via your GitHub App install
ara repos:enable  --repo owner/name          # connect a repo to Ara
ara agents:list                              # your cloud agents
ara agents:run   --id <agentId> --wait       # run an agent, poll to completion
ara ensure-run   --repo owner/name           # find-or-create the issue engineer, then run
ara issues:list  --repo owner/name           # open issues Ara can pick up
ara issues:start --repo owner/name --issue N # start a fix run for issue N
ara audit:run    --repo owner/name           # read-only codebase audit that files GitHub issues
ara runs:list    --id <agentId>              # run history
ara runs:get     --id <agentId> --run <runId># run detail (events + artifacts)
ara wiki:generate --repo owner/name          # generate/refresh the repo wiki
```

All commands print JSON to stdout. Add `--org <slug>` to scope to a workspace.

## HTTP API (if you cannot run the CLI)

- Base URL: `https://api-v1.ara.so`
- Auth: `Authorization: Bearer <supabase-access-token>` (obtain one via `ara auth:login`)
- Workspace scope: send `x-ara-org-slug: <slug>` on cloud-agents, billing, and wiki routes
- Health: `GET https://api-v1.ara.so/healthz`
- Example: `GET https://api-v1.ara.so/v1/cloud-agents` lists your agents

## Docs

- CLI install + quickstart: https://ara.so/cli
- Full public CLI command reference and API mapping: https://ara.so/docs
- Raw install script (inspect before running): https://ara.so/install

## Notes

- One install command works on macOS and Linux (arm64 + x64). The binary
  self-verifies via SHA256 and keeps your session token fresh automatically.
- This file lives at https://ara.so/llms.txt and is the canonical machine-readable
  entry point for agents. Read it first.