# Brain Mac

Brain Mac is the first read-only customer integration. It uses its own API URL, Brain ID, and key
to read identity, profile, memory status, and an optional cited Context canary.

There is no customer login screen yet. For the private beta, Brain issues each design partner a
scoped, revocable project key. The signed Mac app reads the API URL, Brain ID, and key from
owner-only configuration; the customer does not paste a bearer key into the product UI.

## Ready now

The base slice uses four status reads:

1. `getBrain` to verify the Brain for this key.
2. `getProfile` to read current profile counts.
3. `listMemories` to list current Memories.
4. `getMemory` to open one Memory by ID.

When `BRAIN_MEMORY_API_CONTEXT_CANARY_QUERY` names a customer-approved query, the same reversible
connection also calls fast `createContext` and resolves its first citation with `getRecord`. The
app records only status and counts. Ask, Search, synthesis, and visible answers remain unchanged.

The status UI shows only safe state and counts. It does not render memory content, transport errors,
or the bearer key.

## Still on existing paths

The visible Ask/Search loop and write paths remain outside this first slice. Context conflicts and
Object arbitration are still incomplete.

## Customer integration boundary

The customer SpineStore is live. Brain Mac needs its API base, owner-only project key, and Brain ID.
This is a bounded design-partner path, not self-serve signup or broad GA. The public sandbox remains
available for disposable examples and contains no customer memory.

Brain Mac is the first customer integration. The same resources map to operations, health,
finance, video-agent, and GTM products with different Records and Objects.

## Hand this to your coding agent

Give it the API base, Brain ID, and key. It starts read-only, replaces one Context seam, resolves
one citation, runs the app tests, and leaves Ask, Search, and writes alone until you approve the
next cut. Continue with the [migration guide](integrate.html) or give Codex the generated
[`brain-integrate` Skill](downloads/brain-integrate/codex/SKILL.md).