codegram

Queries cross-repo symbol definitions and import dependencies through a code-graph engine.

1|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/apireno/agent-workflow-template --skill codegram-apireno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codegram
Source: https://github.com/apireno/agent-workflow-template/tree/main/.claude/skills/codegram
Command: npx skills add https://github.com/apireno/agent-workflow-template --skill codegram-apireno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Grep-based search cannot trace how a symbol is consumed across multiple repositories, making cross-repo refactoring and dependency validation error-prone. This Skill provides a single query surface over the project's code-graph engine to locate symbol definitions, every cross-repo consumer, and import edges. ## Core Features & Use Cases - Cross-repo symbol lookup: Find a symbol's definition plus every consumer across the repo fleet, not just the current repo. - Import/dependency edge extraction: Surface the cross-repo import edges that feed the RACI-validator and derived-UML tooling. - Engine availability probing: Detect whether a code-graph engine (e.g. codegram via MCP) is wired in .mcp.json, and report cleanly when the fleet-wide retrieval extension is not yet available. - Use Case: Before renaming a shared utility function, query it to list every repo that imports it, so the RACI-validator can flag ownership violations across the fleet. ## Quick Start Ask the agent to run the codegram query for a symbol, for example: query where the function parseConfig is defined and which repos consume it.

Frequently Asked Questions about codegram

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

FAQPage Schema
How do I find all cross-repo consumers of a symbol?

Run the codegram query with the symbol name, optionally scoped with --repo. If the code-graph engine is wired, it returns the definition plus every cross-repo consumer and the import edges between repos.

How do I check if the code-graph engine is connected?

The skill probes the repo's .mcp.json for a codegram MCP server entry. If found, it reports the engine as wired and queries via the mcp__codegram__* tools; otherwise it reports the engine is not yet wired.

Does codegram work without the MCP server configured?

No. Without a code-graph engine registered in .mcp.json, the skill reports that cross-repo navigation is unavailable and falls back to the pattern-based /lane-check skill for enforcement.

What is the difference between codegram and grep for code search?

Grep matches text patterns within files, while codegram resolves object-to-object relationships across repositories, including symbol definitions, consumers, and import edges that plain text search misses.

Why does the cross-repo query report the engine is not wired?

Fleet-wide cross-repo query is a Phase-2 retrieval extension of the code-graph engine. Until the engine indexes more than one repo and exposes the ADR-001 contract, the skill reports the limitation instead of returning partial results.