# The Harness console

The Harness console is the web app for building Ailos. The sidebar has four entries: Orbit, Stats, Content and Workspace, with the organization home under Orbit; settings open from the avatar menu. Every page is backed by named commands and queries, so whatever the interface can do, the API, the CLI and Orbit can do too, under the same permission checks.

## Orbit

Orbit is the console's assistant. The console opens on full-page Orbit; on other pages Orbit is a side panel that knows which page you are on.

- Orbit reads and changes things through the same commands you use, with your permissions.
- When it changes something, it shows a confirmation card or acts directly, depending on the mode you chose; going live and rolling back always show a card.
- Some actions are not available to Orbit, such as connections between organizations.

## Organization home

One card per Ailo: the sites it serves, its live version, conversations over the last 7 days, resolution and helpfulness rates, and links to Stats and Release. While an organization has nothing built, the page lists the five steps of [Build your first Ailo](first-ailo.md).

## Stats

Four cards: resolution rate, teammate involvement, helpfulness and conversation volume; each opens into its details.

- Periods: today, 7 days, 30 days, or a custom range of up to 90 days.
- With two or more Ailos you can look at one of them alone.
- A channel with no conversations in the period is still listed, marked "No conversations in this period".
- At most the latest 5,000 conversations are counted; the page says so when the limit is reached. Spam and test conversations are left out.
- Admins and owners can see it by default (permission `stats.view`).

The query is `console_stats`: `GET /api/tenants/{tenant_id}/console/stats` with `window=today|7d|30d` or `from` / `to`, and an optional `package_id`.

## Content

The system prompt, SOPs and knowledge (FAQ) are edited here, each item with its own version history. The SOP and system prompt pages are still being finished and are not shown to every organization yet; you can do the same through the API, see [Knowledge and SOP API](content-api.md).

## Workspace

| Page | What it does |
| --- | --- |
| Config | Create an Ailo; set its tools and business systems, conversation context and package. Models are not chosen here |
| Test | The test bench: a real chat widget where you try any version of any Ailo and see each turn's steps |
| Evals | Not available yet; the page is a placeholder |
| Release | Versions, going live, rolling back. See [Versions, publishing and going live](releases.md) |
| Runs | Every live turn and its steps. See [The Runtime and run records](runtime.md) |

ailodesk turns on each Workspace page for each organization; the sidebar shows only the pages that are on.

## Settings

Open "My account" from the avatar menu:

- **My account**: name, role, interface language.
- **Members and roles**: invite members and give them roles and permissions.
- **My keys**: personal access keys for scripts and the API. A key has your role's permissions; a read-only key can only call queries.

To sign in from the command line, run `ailo login --product harness` and confirm the code in your browser; no password is typed.
