# Cortex

> Documentation for Cortex, version 1.x.
> Every entry links to the page's markdown source.

Repository: https://github.com/xraph/cortex
Site: https://www.xraph.com/docs/cortex

## Pages

- [Go Packages](https://www.xraph.com/docs/cortex/api-reference/go-packages.md): Quick reference for all Cortex Go packages and their public APIs.
- [HTTP API Reference](https://www.xraph.com/docs/cortex/api-reference/http-api.md): Complete reference for all 36 Cortex REST endpoints — agents, runs, skills, traits, behaviors, personas, checkpoints, memory, and tools.
- [Architecture](https://www.xraph.com/docs/cortex/architecture.md): How Cortex's packages fit together.
- [Configuration](https://www.xraph.com/docs/cortex/concepts/configuration.md): Options and defaults for the Cortex engine and Forge extension.
- [Entities](https://www.xraph.com/docs/cortex/concepts/entities.md): The core data types in Cortex — Agents, Skills, Traits, Behaviors, Personas, Runs, and more.
- [Error Handling](https://www.xraph.com/docs/cortex/concepts/errors.md): Sentinel errors returned by Cortex operations.
- [Identity (TypeID)](https://www.xraph.com/docs/cortex/concepts/identity.md): How Cortex uses prefix-qualified, globally unique identifiers for every entity.
- [Multi-Tenancy](https://www.xraph.com/docs/cortex/concepts/multi-tenancy.md): How Cortex scopes agents, skills, traits, and all entities to app and tenant contexts.
- [Checkpoints](https://www.xraph.com/docs/cortex/execution/checkpoints.md): Human-in-the-loop control — pause runs for approval before proceeding.
- [Memory](https://www.xraph.com/docs/cortex/execution/memory.md): Conversation history, working memory, and summaries for agent context.
- [Orchestration](https://www.xraph.com/docs/cortex/execution/orchestration.md): Run multiple agents together — sequential, parallel, router, hierarchical, and debate strategies with a shared blackboard and handoffs.
- [Runs, Steps & Tool Calls](https://www.xraph.com/docs/cortex/execution/runs.md): How Cortex tracks agent execution — runs, reasoning steps, and tool invocations.
- [Getting Started](https://www.xraph.com/docs/cortex/getting-started.md): Install Cortex and create your first agent in under five minutes.
- [Custom Plugin](https://www.xraph.com/docs/cortex/guides/custom-plugin.md): Write custom Cortex plugins that react to lifecycle events — runs, steps, tool calls, persona resolution, checkpoints, and more.
- [Custom Store](https://www.xraph.com/docs/cortex/guides/custom-store.md): Implement a custom persistence backend by satisfying the composite store.Store interface.
- [Forge Extension](https://www.xraph.com/docs/cortex/guides/forge-extension.md): Mount Cortex into a Forge application as a first-class extension with automatic route registration, migrations, and DI.
- [Full Example](https://www.xraph.com/docs/cortex/guides/full-example.md): Build a customer-support agent end-to-end — skills, traits, behaviors, persona, agent config, engine wiring, and API usage.
- [Behaviors](https://www.xraph.com/docs/cortex/human-model/behaviors.md): Define what an agent does — condition-triggered action patterns.
- [Cognitive Style](https://www.xraph.com/docs/cortex/human-model/cognitive.md): Define how an agent thinks — phase-based reasoning strategies.
- [Communication Style](https://www.xraph.com/docs/cortex/human-model/communication.md): Define how an agent talks — tone, formality, and output preferences.
- [The Human Model](https://www.xraph.com/docs/cortex/human-model/overview.md): How Cortex models AI agents as compositions of human-like traits, skills, and behaviors.
- [Perception](https://www.xraph.com/docs/cortex/human-model/perception.md): Define how an agent sees — attention filters and contextual focus.
- [Personas](https://www.xraph.com/docs/cortex/human-model/personas.md): Compose skills, traits, behaviors, and styles into a complete agent identity.
- [Skills](https://www.xraph.com/docs/cortex/human-model/skills.md): Define what an agent can do — capabilities, tools, and knowledge sources.
- [Traits](https://www.xraph.com/docs/cortex/human-model/traits.md): Define who an agent is — personality dimensions that influence behavior.
- [Introduction](https://www.xraph.com/docs/cortex.md): Human-emulating AI agent orchestration for Go.
- [Audit Trail](https://www.xraph.com/docs/cortex/infrastructure/audit.md): Bridge lifecycle events to an audit backend for compliance and debugging.
- [Observability](https://www.xraph.com/docs/cortex/infrastructure/observability.md): Built-in metrics extension with 11 lifecycle counters.
- [Plugin System](https://www.xraph.com/docs/cortex/infrastructure/plugins.md): Lifecycle hooks for metrics, audit trails, tracing, and custom processing.
- [Fabriq Brain](https://www.xraph.com/docs/cortex/integrations/fabriq.md): Plug fabriq in as a living brain for cortex agents — recall, rich tools, and a learning loop.
- [MongoDB Store](https://www.xraph.com/docs/cortex/stores/mongo.md): Document store using Grove ORM with mongodriver for MongoDB.
- [PostgreSQL Store](https://www.xraph.com/docs/cortex/stores/postgres.md): Production-ready persistence with PostgreSQL using Grove ORM with pgdriver.
- [SQLite Store](https://www.xraph.com/docs/cortex/stores/sqlite.md): Lightweight SQLite backend using Grove ORM with sqlitedriver.