> ## Documentation Index
> Fetch the complete documentation index at: https://cxity.kairaxis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contexity: Local-First Context Continuity for AI Agents

> Contexity gives AI coding agents structured, freshness-aware project memory. Keep Codex, Claude Code, and Cursor on track across every session.

Contexity is a local-first context continuity layer for AI coding agents. It stores structured project knowledge — decisions, investigations, external requirements — and delivers bounded, task-aware context packs so agents like Codex, Claude Code, and Cursor always work with the right information at the right time.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Attach Contexity to a project and connect your first agent host in minutes.
  </Card>

  <Card title="Install" icon="download" href="/install">
    Build Contexity from source and configure your local state home.
  </Card>

  <Card title="How It Works" icon="gear" href="/concepts/how-it-works">
    Understand the core loop: attach, retrieve, work, and close.
  </Card>

  <Card title="Trust & Freshness" icon="shield-check" href="/concepts/trust-and-freshness">
    Learn how Contexity prevents stale or unverified context from steering agents.
  </Card>

  <Card title="Use with Codex" icon="plug" href="/guides/use-with-codex">
    Connect Contexity to Codex through MCP for automatic context retrieval.
  </Card>

  <Card title="Use with Claude Code" icon="plug" href="/guides/use-with-claude-code">
    Set up Claude Code to call Contexity tools automatically during tasks.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/reference/cli-commands">
    Every Contexity command for setup, inspection, and automation.
  </Card>

  <Card title="MCP Tools" icon="wrench" href="/reference/mcp-tools">
    Agent-facing tools exposed through the Contexity MCP server.
  </Card>
</CardGroup>

## The Core Loop

Contexity follows a four-step loop on every agent task:

<Steps>
  <Step title="Attach">
    Contexity creates a project identity and local state for your repository. Run this once per project checkout.
  </Step>

  <Step title="Retrieve">
    Before doing work, the agent asks Contexity for a compact, freshness-aware context pack scoped to the current task.
  </Step>

  <Step title="Work">
    The agent edits, analyzes, and tests with the retrieved context. Contexity maps changed files through the project graph as work progresses.
  </Step>

  <Step title="Close">
    At the end of a task, the agent records what was useful, what changed, any unresolved threads, and heuristic metrics.
  </Step>
</Steps>

<Note>
  Contexity is local-first. All project state lives in `.cxcap/` and your local Contexity state home — no cloud account required.
</Note>