# HRA documentation

Set up HRA, follow your coding sessions in the web app, and use the terminal or CLI when you need more control.

## What do you want to do?

- [Set up HRA](/docs/start/): install the CLI, connect a provider account, and open your first session.
- [Use the web app](/docs/web/): pair a browser, follow the session grid, and send the next instruction.
- [Manage sessions and accounts](/docs/sessions/): continue a conversation, switch providers, inspect usage, or recover a stopped flow.
- [Find a command](/docs/reference/): look up CLI families, machine-readable output, memory, and automation.
- [Check availability](/docs/status/): distinguish the released CLI from runtime rollout and provider support.

## Your machine runs the work. You choose the interface.

HRA keeps Codex and Claude Code sessions on the machine that runs them. The web app shows their synchronized state; the terminal and CLI address the same local accounts and conversations. Other devices can send commands, but do not take over execution.

- `Provider account`: your Codex or Claude Code sign-in, owned by that provider and used on the execution machine.
- `HRA identity`: an email sign-in for optional encrypted sync and paired devices. It does not sign you into a provider.
- `Session`: one HRA conversation with an account, project, and execution machine. Changing its provider does not move a provider-native thread.

Local use does not require an HRA cloud identity. The web app does require sync, an approved machine, and a paired browser. [Current setup limits](/docs/status/) apply to either route.

## Project

HRA is MIT licensed. Read the [security policy](https://github.com/hraness/hra/blob/main/SECURITY.md) before reporting a vulnerability, use [private vulnerability reporting](https://github.com/hraness/hra/security/advisories/new) for suspected security issues, and read the [contribution guide](https://github.com/hraness/hra/blob/main/CONTRIBUTING.md) before a large change.

## Next

- [Start with one machine](/docs/start/)
- [Explore the web app](/docs/web/)