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

# KG operations overview

> Operational entry point for querying, consolidating, monitoring, repairing, and backfilling the Pulse Knowledge Graph.

# KG operations overview

You can operate the Pulse Knowledge Graph through MCP tools, CLI commands, and health endpoints. The graph persists decisions, constraints, alternatives, learnings, entities, requirements, API contracts, tests, and bugs across agent sessions.

<CardGroup cols={2}>
  <Card title="Querying the graph" href="/kg-operations/querying">
    Natural-language, Cypher, decision history, contradictions, and global queries.
  </Card>

  <Card title="Consolidation" href="/kg-operations/consolidation">
    How SQLite queue entries become graph nodes and edges.
  </Card>

  <Card title="Health and monitoring" href="/kg-operations/health">
    Queue depth, dead letters, decay tick freshness, and relevance scores.
  </Card>

  <Card title="Backfill and dedup" href="/kg-operations/backfill">
    Populate the graph from existing artifacts and merge duplicate entities.
  </Card>
</CardGroup>

## Storage

Per-board graph files live at:

```text theme={null}
~/.okto-pulse/boards/{board_id}/graph.lbug
```

Global discovery lives at:

```text theme={null}
~/.okto-pulse/global/discovery.lbug
```

## Operational rule

Do not delete graph files as a repair shortcut. Use health, migration, backfill, dedup, and dead-letter reprocess tools.

## Related pages

* [KG MCP reference](/reference/mcp/kg/overview)
* [Storage paths](/configuration/storage-paths)