> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bijection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# axiom

> Operate Axiom Chat, Agents, evaluation, and AI evidence.

`axiom` is the public AI-operation surface. It calls only `/api/axiom/**` and
never receives product-authoring, deployment, database, connector, or Atelier
Action-execution authority.

```bash theme={null}
go build -o axiom ./cmd/axiom
axiom commands --json
axiom chat list
axiom chat create "Incident analysis"
axiom chat send <thread_id> "Summarize the governed evidence"
axiom operational-agents list
axiom operational-agents show <run_id>
axiom public-agents sessions
axiom public-agents health
```

Search the local contract before spending a credential:

```bash theme={null}
axiom commands --query agent --effect read --compact --json
```

Production credentials live in the same origin-keyed operating-system vault
used by Atelier, while commands and HTTP authority remain Axiom-only:

```bash theme={null}
printf '%s' "$WORKOS_ACCESS_TOKEN" | axiom login --server https://workspace.example
axiom whoami --server https://workspace.example
axiom logout --server https://workspace.example
```

Either product's `login` verifies the credential through its own `whoami`
route; either `logout` removes the shared vault entry. `--token-file` is an
explicit automation override or login import, not the interactive persistence
mechanism.

The generated Go, Python, and TypeScript Axiom SDKs are built from the
independently reviewed `api/axiom.openapi.json` contract and contain only Axiom routes.
They are published as `axiom` for Go and Python and `@bijection/axiom` for
TypeScript. Axiom can plan or propose a world change, but only an ordinary
Atelier Action can execute it after current-authority revalidation and review.

```ts theme={null}
import { AxiomClient } from "@bijection/axiom";

const axiom = new AxiomClient({
  token: process.env.AXIOM_TOKEN!,
  baseURL: "https://workspace.example",
});
const threads = await axiom.chat.chatThreadsList({ limit: 25n });
```

Use `--work-scope kind/key` to keep a conversation or an operational Agent Run
inside one active Project. Discover choices with `atelier work-scopes list`.
Every request rereads your membership; existing conversations and Agent results
stay bound to the scope in which they were created.

```bash theme={null}
axiom --work-scope audit/A-1 chat list
axiom --work-scope audit/A-1 chat create "Audit A-1"
```