Skip to main content
subagent CX Codex

knowledge-mapper — Claude Code subagent: what it does, how to install

knowledge-mapper turns a subject into a map of concepts: nodes, typed links, clusters and routes between ideas. Handy when a topic is too big to keep in your head at once.

no license ★ 1,357 updated 2026-03-01

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/knowledge-mapper.md
Open on GitHub

What knowledge-mapper does

Every concept becomes a node carrying a domain, an importance weight and coordinates. Links between nodes get a type and a strength; the types run from is-a and part-of to causes, requires, opposite-of and leads-to. Groups of related nodes become clusters with a centroid and a coherence score.

You drive it with starred commands: *build-graph reads the current context, *map-connections lists what a concept touches, *trace-path connects two ideas, *find-gaps reports empty areas, *export-graph writes the result out. Activation runs /semantic:tree-init, loads stored maps from .wfgy/maps/, then prints *help. The agent runs on sonnet and can read, write and search files, run Bash, and fetch pages from the web.

Helper commands live in .claude/commands/semantic/ and .claude/commands/reasoning/. Skip them and activation's init step has nothing to call, because /semantic:tree-init resolves to a file in that first folder. The agent itself is one file: .claude/agents/knowledge-mapper.md.

What it helps with

  • split a sprawling topic into nodes and links
  • trace a route between two concepts
  • lay out a study order for an unfamiliar field
  • spot which parts of a knowledge map stay empty
  • export a concept graph for a write-up

Example prompts for the agent

  • Map the concepts in this spec: run *build-graph, then *visualize-map.
  • How do transactions and isolation levels connect? Use *trace-path.
  • Run *find-gaps over my notes and tell me what's missing.

How to install knowledge-mapper

Manually: put the files in place

.claude/agents/knowledge-mapper.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about knowledge-mapper

How to install knowledge-mapper in Claude Code?

Drop the agent file into your project at .claude/agents/knowledge-mapper.md. That path is the install for Claude.

What does knowledge-mapper do?

It builds a graph of concepts with typed, weighted links and clusters, then answers questions about routes, gaps and study order.

What does it need to work?

The command files under .claude/commands/semantic/ and .claude/commands/reasoning/, since activation calls /semantic:tree-init. Saved maps are read from .wfgy/maps/.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set112

The whole set →
svelte-testing The svelte-testing subagent helps test Svelte and SvelteKit apps, from component behavior to end-to-end flows. Use it when you need coverage for UI interactions or server-side functions. CX Codex ★ 1,357repo stars logic-synthesizer logic-synthesizer splits a hard problem into several parallel solution paths, weighs each one and merges the strongest parts into a single answer. CX Codex ★ 1,357repo stars cognitive-debugger cognitive-debugger — a diagnostic subagent for Claude Code that investigates reasoning breakdowns, traces error propagation across logic chains, and applies WFGY recovery protocols. CX Codex ★ 1,357repo stars test-automator test-automator is a Claude Code subagent that plans automated tests and connects them to CI/CD. It activates for coverage work or when a project needs a testing setup from scratch. CX Codex ★ 1,357repo stars full-stack-developer full-stack-developer — a subagent for full-cycle web engineering that crafts interfaces, builds server logic, and connects databases. Useful when delivering end-to-end features across the entire stack. CX Codex ★ 1,357repo stars handoff-continue handoff-continue writes a handoff document about the current work and starts a fresh Claude session in a Zellij pane with that document as its input. CX Codex +1 ★ 1,357repo stars decision-navigator decision-navigator structures complex choices, scores trade-offs, and quantifies risk factors. Useful when you need to assess the reversibility and consequences of technical plans. CX Codex ★ 1,357repo stars dependency-mapper The dependency-mapper command connects code dependencies, Linear tasks, and Git history into project maps. Use it to spot cycles, blockers, and task order. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open