# Cortex Docs

> Product docs for Cortex Chat, Code, Bot, Design, and the Cortex CLI. Platform API lives elsewhere.

## Docs

- [Quickstart](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/getting-started/quickstart.md): Open Cortex in a browser, get a first answer from Chat, then sign in for Code, Bot, and Design.
- [What is Cortex](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/getting-started/what-is-cortex.md): Four products and a CLI behind one account on cortex.foundation — Chat, Code, Bot, Design, and the Cortex CLI.
- [Accounts and sign-in](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/getting-started/accounts.md): Chat works as a guest. Sign in once for projects, files, Code, Bot, and the CLI — the same account everywhere.
- [Plans and quotas](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/getting-started/plans.md): Guest, Free, Go, Plus, and Pro as listed in Settings → Plan & billing. Quotas fail closed and tell you when they reset.
- [Settings](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/getting-started/settings.md): Theme, language, answer font, keyboard shortcuts, default models, integrations, privacy, and billing — everything under Settings in the web app.
- [Downloads](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/getting-started/downloads.md): Every way to run Cortex — the web app, the Cortex desktop app for Chat and Code, the Bot desktop app, the Design desktop app, and the CLI.
- [Desktop app (Chat + Code)](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/getting-started/desktop.md): The Cortex desktop app carries Chat and Code, and adds This PC and SSH hosts for Code sessions. The browser stays Cloud-only.
- [Troubleshooting](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/getting-started/troubleshooting.md): What the web app shows when something is off, what it means, and what to do — gates, quotas, reconnects, and product-facing errors.
- [System status](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/status.md): Live availability for Cortex Web, API, Chat, Code, and Bot — incidents, maintenance, and history.
- [Security and privacy](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/security/overview.md): What Cortex stores, what it never stores, which cookies run, where your code executes, and how to export or delete your data.
- [Chat guides](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/index.md): Everything for Cortex Chat — conversations, projects, Library, plans, models, tools, research, images, and how a turn actually runs.
- [Overview](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/overview.md): What Cortex Chat is for, how the sidebar is organised, what a thread offers, and when to switch to Code or Bot.
- [Chat quickstart](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/quickstart.md): From an open tab to a useful first conversation — send, attach, pick a model, and keep the thread in a project.
- [Projects](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/projects.md): A project keeps its own instructions, its chats, and its files together. Everything you say in a project's chats is read with those instructions in front of it.
- [Library](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/library.md): Everything you uploaded to a chat or a project, and everything the assistant produced. Files stay in Library when a chat is deleted.
- [Plans](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/plans.md): A plan is a task list the model can build and keep up to date while you work. Start one from any chat, or from Planning.
- [Models and thinking](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/models.md): Pick a model per conversation from the composer chip, set how long Cortex thinks before answering, and know what happens at peak hours.
- [Tools and connectors](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/tools.md): Built-in Chat tools, connected apps under Customize → Connectors, GitHub in Settings → Integrations, and MCP servers — and which product each connection reaches.
- [Sharing and teams](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/sharing.md): Cortex Chat is per account. What that means for threads, projects, plans, and files — and where team features live.
- [Deep Research](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/deep-research.md): Plan the questions, read live sources, and write a cited report. A Chat feature — not a Code tool and not a Bot skill.
- [Image generation](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/images.md): Ask Chat for a picture and Cortex-Image-1 paints it. Generated images land in Library. On Free and Guest, images are a daily quota — not a paywall.
- [Origin check](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/origin-check.md): Attach media and ask whether it is authentic. Cortex waits for a verdict, and says so plainly when the check cannot run.
- [Voice](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/voice.md): Dictate with the mic and hear an answer with Listen. Both controls appear only when the deployment can transcribe or speak.
- [Memory](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/memory.md): Cortex remembers preferences and facts you share so answers get more personal over time. Review or delete individual memories under Settings → Data & privacy.
- [Canvases](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/canvases.md): A document that sits beside the conversation. Draft it yourself or ask Cortex to — and keep editing after the chat moves on.
- [How Chat works](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/how-it-works.md): A Chat turn is one tool-calling loop: the model asks for tools, Chat runs them, results flow back, and the loop ends when the model stops or hits Chat's round budget.
- [Streaming](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/chat/streaming.md): Answers appear as they are written — tokens, then tools, then the finished reply. If the connection drops, the thread reconnects; you do not resend.
- [Code guides](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/index.md): Cortex Code — a coding agent that works inside your repository on an isolated runtime. Sessions, Ask / Plan / Agent, GitHub, Cloud guests, desktop hosts, the CLI, and pull-request review.
- [Cortex Code](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/overview.md): A coding agent that works inside the repository — sessions, isolated runtimes, and pull-request reviews. Web Code is Cloud-only; This PC and SSH live on desktop and the CLI.
- [Code quickstart](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/quickstart.md): Sign in, connect GitHub, start a Cloud session on a repository, and read the timeline — in the web app.
- [Sessions](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/sessions.md): A Code session is a timeline of the task you asked for and the work that followed — files read, edits, commands, plans — not a chat transcript.
- [Ask, Plan, Agent](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/interactions.md): Choose how much a Code turn may change. Ask reads and explains, Plan proposes, Agent edits and runs. The choice rides on the turn; the session row holds the default.
- [Connect GitHub](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/github.md): Cortex Code reaches repositories through Connect GitHub — on Code Home, in the repository picker, and under Settings → Integrations. No personal-access-token field.
- [Cloud runtimes](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/cloud.md): Every web Code session runs in its own isolated Cloud guest, prepared by the agent for that repository. Not the Chat Python sandbox, not the API process.
- [Code on desktop](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/desktop.md): This PC and SSH hosts for Code sessions exist on the desktop app and the CLI. The browser stays Cloud-only — that is where the code runs, not a missing feature.
- [Code in the terminal](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/cli.md): The Cortex CLI drives the same Code sessions from a terminal — interactive, one-shot, or headless in CI. Same account, Cloud by default, This PC and SSH by opt-in.
- [Cortex Security](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/security.md): GitHub pull-request review without pasting a diff. The change stays in the repository; Cortex reads it there and posts a check run that stays failed when it fails.
- [How Code works](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/how-it-works.md): Workspace tools execute inside the attached Cloud guest — never in the API process, never in Chat's Python sandbox. Modes withhold mutating tools; compaction fails closed.
- [Code troubleshooting](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/code/troubleshooting.md): Gates, Reconnect, Cloud availability, modes that will not edit, and what a failed Cortex Security review means.
- [Bot guides](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/index.md): Cortex Bot — a bot with its own computer. Browses, clicks, and works on a desktop you can watch; parks consequential steps behind approvals; runs routines on your local weekday hours.
- [Cortex Bot](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/overview.md): A bot with its own computer, listed once in the sidebar. An account with no bots gets the setup form, not an empty list. Guests see the public product page.
- [Bot quickstart](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/quickstart.md): Sign in, create your first bot, open its computer, give it a task, and approve its first consequential step.
- [Computer](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/computer.md): The Computer rail is a live desktop on a Cloud guest — screen, browser, shell — not a slideshow of screenshots. Web is Cloud-only; This PC lives on the Bot desktop app.
- [Bot tools](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/tools.md): The parent tool catalog a bot receives — files and shell, computer use, browser, web, memory and skills, user-visible messages, nested tasks, agents, artifacts, and the plugins you enabled for Bot.
- [Approvals](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/approvals.md): Allow / Deny / Always. A bot parks consequential steps — connected-app changes and dangerous computer actions — and nothing runs until you choose.
- [Routines](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/routines.md): Scheduled work on a bot you own. Routines fire in the owner's local weekday hours, pause and resume from the Computer rail, and follow your account across devices.
- [Skills](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/skills.md): Skills are instruction bundles a bot can follow. Enable first-party skills on a bot you own; the bot loads one when the task calls for it.
- [Bot desktop](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/desktop.md): The Cortex Bot desktop app — a home for your agents, routines, and channels, with This PC as a host for a bot's computer. It has no Chat or Code sidebar.
- [How Bot works](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/how-it-works.md): What you see is a few short bubbles, not the inner loop. No round counter; a 15-minute turn deadline; six identical tool calls stop a turn. An active turn wakes a hibernated guest first.
- [Bot troubleshooting](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/bot/troubleshooting.md): Connecting versus Stream Unavailable, parked steps that do not run, the setup form, missing tools, and turns that stop.
- [Cortex CLI](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/index.md): Cortex Code in your terminal — an interactive session view, one-shot runs, headless mode for CI, and the extension points: MCP servers, skills, agents, hooks, plugins.
- [Install the CLI](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/install.md): Install Cortex CLI on macOS, Linux, or Windows. The installer verifies a SHA-256 checksum before it writes anything; cortex upgrade keeps it current.
- [Sign in](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/sign-in.md): cortex login opens the browser flow; a device code covers machines without one; API keys and tokens cover CI. Credentials live in your OS keyring, never in a file in the repository.
- [CLI quickstart](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/quickstart.md): From nothing installed to a working Cortex Code session in the terminal — install, sign in, first turn, AGENTS.md, and how much autonomy to grant.
- [The TUI](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/tui.md): What is on screen when you run cortex — the timeline and its rows, the composer, the status line, the footer, queueing follow-ups, interrupting, and the panels behind Ctrl+K.
- [Slash commands](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/slash-commands.md): Everything you can type after / in the Cortex CLI composer — model, mode, permissions, plan, goal, sessions, files, MCP, diagnostics — and how to add your own.
- [Modes and permissions](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/modes-and-permissions.md): Agent / Plan / Ask, the Spec lock, approval prompts, the sandbox, the permission table, and the model picker's effort radios — every control over what the CLI may do.
- [Goals](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/goal.md): /goal keeps a long-horizon objective attached to the session. It survives the end of a turn, context compaction, and resume — the agent keeps planning, acting, and verifying until the work is evidence-complete.
- [Sessions](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/sessions.md): Every interactive run is a session written to disk as you go — list, resume, rewind, fork, export, import, share, lock, and clean up.
- [Keyboard shortcuts](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/keyboard.md): Every key binding in the Cortex CLI, grouped by where it applies. Press Ctrl+X in the TUI for the in-app overlay, or ? for help.
- [Headless and one-shot runs](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/headless.md): cortex exec for CI and scripts — autonomy levels, JSON output, turn and time limits — and cortex run for a single streamed request from your own shell.
- [Configuration](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/configuration.md): config.toml keys, profiles, precedence, the environment variables the CLI reads, where data lives on disk, and how to select the Cloud, This PC, or SSH host.
- [Extend the CLI](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/extend.md): MCP servers, skills, agents and subagents, hooks, plugins, custom commands, and themes — every extension point in the Cortex CLI.
- [CLI troubleshooting](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/cli/troubleshooting.md): Start with four commands, then work through the product-facing messages — the coding service, hosts that refuse, the agent that will not edit, MCP, quotas, timeouts, disk.
- [Design guides](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/design/index.md): Cortex Design — persistable canvases hosted from Chat or Code and edited in the Design desktop app. Frames, notes, options, and a Library of components, pages, and tokens.
- [Cortex Design](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/design/overview.md): Persistable canvases from Chat or Code, edited in a separate desktop app. No fourth mode in the web shell.
- [Design desktop](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/design/desktop.md): The working UI for Cortex Design is a separate desktop app. Chat and Code create canvases; you edit them here.
- [Canvases](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/design/canvases.md): Boards you host from Chat or Code — frames, notes, options, and the host binding. Default title Untitled canvas; deleting hides it from the list.
- [Design library](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/design/library.md): Components, pages, and tokens you reuse across canvases. Thumbnails are uploaded, not rendered on this site. Not the same object as Chat's file Library.
- [Public API](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/api/overview.md): Problem type URIs. Sign in via the app. The inference Platform API is coming soon.
- [Errors](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/api/errors.md): RFC 9457 problem+json. Branch on code. type URIs live on this site.
- [Problem catalog](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/index.md): Dereferenceable type URIs for RFC 9457 documents from api.cortex.foundation.
- [validation_failed](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/validation_failed.md): Validation failed. HTTP 422.
- [bad_request](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/bad_request.md): Bad request. HTTP 400.
- [idempotency_key_reuse](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/idempotency_key_reuse.md): Idempotency key reused with a different body. HTTP 400.
- [payload_too_large](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/payload_too_large.md): Payload too large. HTTP 413.
- [unsupported_media_type](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/unsupported_media_type.md): Unsupported media type. HTTP 415.
- [unauthenticated](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/unauthenticated.md): Authentication required. HTTP 401.
- [invalid_credential](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/invalid_credential.md): Credential is invalid or expired. HTTP 401.
- [forbidden](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/forbidden.md): Not permitted. HTTP 403.
- [entitlement_required](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/entitlement_required.md): Your plan does not include this. HTTP 403.
- [not_found](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/not_found.md): Not found. HTTP 404.
- [conflict](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/conflict.md): Conflict. HTTP 409.
- [gone](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/gone.md): No longer available. HTTP 410.
- [invalid_state](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/invalid_state.md): Not allowed in the current state. HTTP 422.
- [quota_exceeded](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/quota_exceeded.md): Plan limit reached. HTTP 429.
- [rate_limited](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/rate_limited.md): Too many requests. HTTP 429.
- [concurrency_limit_reached](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/concurrency_limit_reached.md): Too many runs at once. HTTP 429.
- [safety_intervention](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/safety_intervention.md): We want to make sure you are safe. HTTP 403.
- [content_policy](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/content_policy.md): Blocked by content policy. HTTP 403.
- [jurisdiction_restricted](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/jurisdiction_restricted.md): Not available in your region. HTTP 403.
- [internal](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/internal.md): Something went wrong on our side. HTTP 500.
- [upstream_failure](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/upstream_failure.md): An upstream service failed. HTTP 502.
- [upstream_timeout](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/upstream_timeout.md): An upstream service timed out. HTTP 504.
- [service_unavailable](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/service_unavailable.md): Temporarily unavailable. HTTP 503.
- [no_capacity](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/problems/no_capacity.md): No capacity for this model right now. HTTP 503.
- [Changelog](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/changelog.md): What shipped in Cortex Chat, Code, Bot, Design, and the CLI — dated, with a link to the surface it changed.
- [Platform API](https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/platform.md): Coming soon. Not implemented in this repository.