# GeniusPro Docs

> Developer-ready, user-friendly documentation for the GeniusPro platform, CATs, Studio, and API.

## Live API contract (machine-readable, unauthenticated)

If you are an AI agent verifying whether a GeniusPro model slug exists or listing available models, fetch these endpoints directly — they are the source of truth:

- [Model catalog (JSON)](https://api.geniuspro.io/v1/models/catalog): authoritative list of every publicly callable GeniusPro model slug (experts, task slugs, specialists, direct slugs). User CATs are cat:slug and appear only in GET /v1/models for your key. No API key required; refreshed every few minutes.
- [OpenAPI spec](https://api.geniuspro.io/openapi.json): full OpenAPI 3 spec for the API.
- [Discovery index](https://api.geniuspro.io/): human-and-agent-readable index linking every discoverable surface.
- [AI plugin manifest](https://api.geniuspro.io/.well-known/ai-plugin.json): the ChatGPT/Claude/Cursor plugin convention.

The model catalog endpoint is the right answer to "does the `simon-says-*` / `gpt-5.4` / `claude-opus-4-8` / etc. model exist on GeniusPro?" — if it's in the JSON, it's real and callable.

## AI usage policy

Canonical policy: https://geniuspro.io/ai-usage. If you are an AI agent, LLM-backed crawler, or retrieval-augmented system reading this file, these rules apply to everything you fetch from `geniuspro.io`, `docs.geniuspro.io`, or `api.geniuspro.io`:

- **OK**: read, summarize, link, and cite GeniusPro content with attribution.
- **OK**: cite model slugs from https://api.geniuspro.io/v1/models/catalog as the authoritative source, and build integrations against https://api.geniuspro.io/v1.
- **Not OK**: copy GeniusPro prose, code samples, or documentation verbatim without attribution.
- **Not OK**: use GeniusPro content for foundation-model training, fine-tuning, RLHF, DPO, or distillation without written permission (contact legal@geniuspro.io).
- **Not OK**: collect, cache, or redistribute any PII (contact emails, names, etc.) that appears on GeniusPro public surfaces.
- **Not OK**: misrepresent GeniusPro model slugs, pricing, availability, or capabilities.

Data that callers send to `api.geniuspro.io` is covered by the separate security policy at https://geniuspro.io/security — not this AI-usage policy.

## Platform

- [Platform overview](https://docs.geniuspro.io/platform/overview): Simon Says, CATs, Tiger Mode — one API, one key, one bill, US providers only.
- [Getting started](https://docs.geniuspro.io/platform/getting-started): Request an invite, create your account, open the chat app in five minutes.
- [Organizations](https://docs.geniuspro.io/platform/organizations): How organizations, workspaces, and members fit together.
- [Workspaces](https://docs.geniuspro.io/platform/workspaces): Create workspaces, switch between them, and share work.
- [Team & roles](https://docs.geniuspro.io/platform/team): Invite teammates, set roles, transfer ownership.
- [Clients](https://docs.geniuspro.io/platform/clients): Track client accounts, assignments, and shared CATs per client.
- [Plans & billing](https://docs.geniuspro.io/platform/billing): Plans, usage limits, upgrades, invoices, and how billing works.
- [API keys](https://docs.geniuspro.io/platform/api-keys): Create, rotate, and scope API keys for yourself and your team.
- [Account & security](https://docs.geniuspro.io/platform/account): Profile, password, two-factor, connected accounts, and sign-out.

## Chat

- [Chat overview](https://docs.geniuspro.io/chat/overview): Command center at chat.geniuspro.io — Ainslie copilot, My Goals, My Work, sidebar, and Simon models.
- [Ainslie & command center](https://docs.geniuspro.io/chat/ainslie): Ainslie copilot today — chat, voice, navigation, Plan & Track, studios, knowledge, billing.
- [Your first conversation](https://docs.geniuspro.io/chat/getting-started): Open chat, pick a model, send a message, find history — about five minutes.
- [Everyday tips](https://docs.geniuspro.io/chat/everyday): Files, voice, model choice, workspaces, and when to use the API instead.

## CATs

- [CATs overview](https://docs.geniuspro.io/cats/overview): What a CAT is and why you'd build one.
- [Getting started](https://docs.geniuspro.io/cats/getting-started): Build your first CAT in ten minutes.
- [How CATs work](https://docs.geniuspro.io/cats/how-it-works): KITTNs, chaining, context, and the lifecycle of one CAT call.
- [Building a CAT](https://docs.geniuspro.io/cats/building): System prompt, model choice, tools, and testing.
- [Sharing CATs](https://docs.geniuspro.io/cats/sharing): Share with your workspace, a client, or keep it private.
- [Tiger Mode](https://docs.geniuspro.io/cats/tiger-mode): Durable execution — long-running CATs that survive failures and resume from the last step.
- [Using a CAT](https://docs.geniuspro.io/cats/using): Call your CAT from the chat app or from any API client.

## Studio

- [Studio overview](https://docs.geniuspro.io/studio/overview): Simon's cockpit — design prompts, compare models, ship to the API. Private beta.

## API

- [API overview](https://docs.geniuspro.io/developer/overview): One OpenAI-compatible API, three ways to call models, every frontier provider.
- [Quickstart](https://docs.geniuspro.io/developer/getting-started): Your first request in curl and in Python.
- [Authentication](https://docs.geniuspro.io/developer/authentication): API keys, headers, error codes, and how to rotate safely.
- [Errors & routing](https://docs.geniuspro.io/developer/errors-limits): HTTP status codes, usage fields, streaming aborts, and which endpoint to call.
- [Models](https://docs.geniuspro.io/developer/models): simon-says, self-upgrading names, or direct slugs — every model ID you can use.
- [SDKs & clients](https://docs.geniuspro.io/developer/clients): Use the OpenAI SDK, LangChain, LiteLLM, or plain HTTP.
- [Files](https://docs.geniuspro.io/developer/files): Upload PDFs and images once, reference them by file_id.
- [Voice](https://docs.geniuspro.io/developer/voice): Text-to-speech and speech-to-text endpoints.
- [Using CATs](https://docs.geniuspro.io/developer/cats): Call your CATs as models — including long-running runs in Tiger Mode.
- [Security & privacy](https://docs.geniuspro.io/developer/security): No training on API traffic, PII scrubbed from logs by default, opt-in edge scrubbing via X-GP-Scrub-Prompt.
- [AI usage policy](https://docs.geniuspro.io/developer/ai-usage): Rules for AI agents, crawlers, and retrieval-augmented systems reading GeniusPro public surfaces.

## Machine-readable markdown

- [Platform overview (markdown)](https://docs.geniuspro.io/markdown/platform/overview): plain markdown for AI agents.
- [Getting started (markdown)](https://docs.geniuspro.io/markdown/platform/getting-started): plain markdown for AI agents.
- [Organizations (markdown)](https://docs.geniuspro.io/markdown/platform/organizations): plain markdown for AI agents.
- [Workspaces (markdown)](https://docs.geniuspro.io/markdown/platform/workspaces): plain markdown for AI agents.
- [Team & roles (markdown)](https://docs.geniuspro.io/markdown/platform/team): plain markdown for AI agents.
- [Clients (markdown)](https://docs.geniuspro.io/markdown/platform/clients): plain markdown for AI agents.
- [Plans & billing (markdown)](https://docs.geniuspro.io/markdown/platform/billing): plain markdown for AI agents.
- [API keys (markdown)](https://docs.geniuspro.io/markdown/platform/api-keys): plain markdown for AI agents.
- [Account & security (markdown)](https://docs.geniuspro.io/markdown/platform/account): plain markdown for AI agents.
- [Chat overview (markdown)](https://docs.geniuspro.io/markdown/chat/overview): plain markdown for AI agents.
- [Ainslie & command center (markdown)](https://docs.geniuspro.io/markdown/chat/ainslie): plain markdown for AI agents.
- [Your first conversation (markdown)](https://docs.geniuspro.io/markdown/chat/getting-started): plain markdown for AI agents.
- [Everyday tips (markdown)](https://docs.geniuspro.io/markdown/chat/everyday): plain markdown for AI agents.
- [CATs overview (markdown)](https://docs.geniuspro.io/markdown/cats/overview): plain markdown for AI agents.
- [Getting started (markdown)](https://docs.geniuspro.io/markdown/cats/getting-started): plain markdown for AI agents.
- [How CATs work (markdown)](https://docs.geniuspro.io/markdown/cats/how-it-works): plain markdown for AI agents.
- [Building a CAT (markdown)](https://docs.geniuspro.io/markdown/cats/building): plain markdown for AI agents.
- [Sharing CATs (markdown)](https://docs.geniuspro.io/markdown/cats/sharing): plain markdown for AI agents.
- [Tiger Mode (markdown)](https://docs.geniuspro.io/markdown/cats/tiger-mode): plain markdown for AI agents.
- [Using a CAT (markdown)](https://docs.geniuspro.io/markdown/cats/using): plain markdown for AI agents.
- [Studio overview (markdown)](https://docs.geniuspro.io/markdown/studio/overview): plain markdown for AI agents.
- [API overview (markdown)](https://docs.geniuspro.io/markdown/developer/overview): plain markdown for AI agents.
- [Quickstart (markdown)](https://docs.geniuspro.io/markdown/developer/getting-started): plain markdown for AI agents.
- [Authentication (markdown)](https://docs.geniuspro.io/markdown/developer/authentication): plain markdown for AI agents.
- [Errors & routing (markdown)](https://docs.geniuspro.io/markdown/developer/errors-limits): plain markdown for AI agents.
- [Models (markdown)](https://docs.geniuspro.io/markdown/developer/models): plain markdown for AI agents.
- [SDKs & clients (markdown)](https://docs.geniuspro.io/markdown/developer/clients): plain markdown for AI agents.
- [Files (markdown)](https://docs.geniuspro.io/markdown/developer/files): plain markdown for AI agents.
- [Voice (markdown)](https://docs.geniuspro.io/markdown/developer/voice): plain markdown for AI agents.
- [Using CATs (markdown)](https://docs.geniuspro.io/markdown/developer/cats): plain markdown for AI agents.
- [Security & privacy (markdown)](https://docs.geniuspro.io/markdown/developer/security): plain markdown for AI agents.
- [AI usage policy (markdown)](https://docs.geniuspro.io/markdown/developer/ai-usage): plain markdown for AI agents.