# Oka Docs

> https://docs.oka.so

## Pages

- [Reason HTTP API](https://docs.oka.so/api/reason/): Complete REST reference for reason.oka.so — event ingestion, learning queries, consolidation, backlog, search, and ontology.
- [Usage, plans & limits](https://docs.oka.so/concepts/billing/): What counts as billable usage, how plan limits are enforced, and how storage overage works.
- [How consolidation works](https://docs.oka.so/concepts/consolidation/): How raw friction events become ranked organizational intelligence.
- [The feedback loop](https://docs.oka.so/concepts/feedback/): How Oka gets smarter the more your team uses it.
- [Core concepts](https://docs.oka.so/concepts/): The mental model for building on Oka — friction events, consolidation, organizational intelligence.
- [Amazon Q Developer integration](https://docs.oka.so/cookbook/amazon-q/): Setting up Oka Reason with Amazon Q Developer.
- [Claude Code integration](https://docs.oka.so/cookbook/claude-code/): Deep integration guide for using Oka Reason with Claude Code.
- [CLAUDE.md patterns](https://docs.oka.so/cookbook/claude-md/): Instrument your CLAUDE.md to make agents use Oka automatically.
- [Cline integration](https://docs.oka.so/cookbook/cline/): Setting up Oka Reason with Cline (VS Code extension).
- [Codex CLI integration](https://docs.oka.so/cookbook/codex/): Setting up Oka Reason with OpenAI's Codex CLI.
- [Continue.dev integration](https://docs.oka.so/cookbook/continue/): Setting up Oka Reason with Continue.dev.
- [Cursor integration](https://docs.oka.so/cookbook/cursor/): Setting up Oka Reason in Cursor.
- [Enforcement levels](https://docs.oka.so/cookbook/enforcement/): Three strategies for ensuring agents consistently use Oka.
- [Hermes Agent integration](https://docs.oka.so/cookbook/hermes/): Setting up Oka Reason with the Hermes agent framework.
- [Cookbook](https://docs.oka.so/cookbook/): Practical recipes for getting the most out of Oka Reason.
- [JetBrains integration](https://docs.oka.so/cookbook/jetbrains/): Setting up Oka Reason in JetBrains IDEs (IntelliJ, WebStorm, PyCharm, etc.).
- [Team rollout](https://docs.oka.so/cookbook/team-rollout/): From solo developer to org-wide Oka adoption.
- [VS Code Copilot integration](https://docs.oka.so/cookbook/vscode/): Setting up Oka Reason with GitHub Copilot in VS Code.
- [Windsurf integration](https://docs.oka.so/cookbook/windsurf/): Setting up Oka Reason in Windsurf (Codeium).
- [Workspace design](https://docs.oka.so/cookbook/workspaces/): How to structure Oka workspaces for maximum intelligence signal.
- [Zed integration](https://docs.oka.so/cookbook/zed/): Setting up Oka Reason in the Zed editor.
- [Oka](https://docs.oka.so/): The institutional intelligence platform for software teams. Capture friction, compound learnings, make every agent session smarter.
- [Getting started](https://docs.oka.so/quickstart/): Get up and running with Oka in under 5 minutes.
- [Reason HTTP API](https://docs.oka.so/quickstart/reason-http/): Call Reason from a non-MCP client via REST.
- [Reason (MCP)](https://docs.oka.so/quickstart/reason/): Connect your MCP client to Oka's intelligence layer in 3 minutes.
- [Reason — MCP tools](https://docs.oka.so/reason/): Overview of the MCP tools exposed by Oka's institutional intelligence layer.
- [Read tools](https://docs.oka.so/reason/read-tools/): Query accumulated organizational intelligence — context, patterns, decisions, search, backlog.
- [@oka-core/reason](https://docs.oka.so/reason/sdk/): MCP server package for the Reason intelligence layer.
- [Write tools](https://docs.oka.so/reason/write-tools/): Record decisions, observations, deviations, completions and learnings as your agents work.
- [Troubleshooting](https://docs.oka.so/troubleshooting/): Solutions to common issues when using Oka Reason.