ftm-map

Index and query codebases via a persistent SQLite knowledge graph.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kkudumu/feed-the-machine --skill ftm-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ftm-map
Source: https://github.com/kkudumu/feed-the-machine/tree/main/ftm-map
Command: npx skills add https://github.com/kkudumu/feed-the-machine --skill ftm-map

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tree-sitter-language-pack, sqlite-vec, scipy, fast-pagerank, pygments, and includes scripts (resource) components.

What problem does it solve?

Claude Code often forgets project context across conversations, making end-to-end automation tedious. ftm-map provides a persistent knowledge graph of your codebase that captures files, symbols, and references to enable coordinated workflows and better decision-making.

Core Features & Use Cases

  • 5-table graph: files, symbols, refs, file_edges, symbol_edges, with FTS5 full-text search over symbols.
  • Bootstrap and incremental indexing to keep the map up to date with code changes.
  • Queries: blast radius, dependency chains, context selection, symbol info, and statistics to reason about code impact.
  • Generates INTENT.md and ARCHITECTURE.mmd visuals to document structure and dependencies.

Quick Start

Run the bootstrap workflow to index your project, then query for blast radius, dependencies, or context.

Frequently Asked Questions about ftm-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a persistent code graph to track codebase dependencies across conversations?

A persistent code graph stores your codebase structure in a 5-table SQLite schema with FTS5 full-text search, capturing files, symbols, and references. It enables blast radius, dependency chain, and context selection queries to reason about code impact and support better decision-making across conversations.

How do I analyze the blast radius of code changes using a knowledge graph?

Query the code graph for blast radius directly after running the bootstrap indexing workflow. The query functionality uses mapped symbol edges and file edges to identify affected components, helping you reason about the structural impact of code modifications.

Does ftm-map support incremental indexing for large codebases?

Yes, ftm-map supports incremental indexing to keep your code map updated with code changes without needing a full rebuild. This maintains an accurate persistent knowledge graph efficiently as your project evolves over time.

Can I use tree-sitter and sqlite-vec for code indexing in Python?

Yes, ftm-map uses tree-sitter-language-pack for symbol extraction and sqlite-vec for vector storage within a 5-table SQLite schema. This combination enables structural code indexing and FTS5 full-text search over symbols, requiring Python 3.10 or higher.

What's the best way to visualize code architecture and dependency chains?

Generate INTENT.md and ARCHITECTURE.mmd visual files from the indexed code graph to document project structure and dependencies. These outputs provide visual representations of architecture and dependency chains, complementing the structural query capabilities for impact analysis.

Why does Claude Code forget project context and how do I maintain it?

Claude Code loses project context across conversations because it lacks persistent codebase awareness. ftm-map solves this by building a persistent knowledge graph that captures files, symbols, and references, enabling coordinated end-to-end automation workflows.