Skip to main content

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.

Querying the graph

Natural-language, Cypher, decision history, contradictions, and global queries.

Consolidation

How SQLite queue entries become graph nodes and edges.

Health and monitoring

Queue depth, dead letters, decay tick freshness, and relevance scores.

Backfill and dedup

Populate the graph from existing artifacts and merge duplicate entities.

Storage

Per-board graph files live at:
~/.okto-pulse/boards/{board_id}/graph.lbug
Global discovery lives at:
~/.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.
Last modified on May 9, 2026