agentifind

Extract code structure and validate quality using language servers and tree-sitter.

97|28|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/AvivK5498/Beads-Kanban-UI --skill agentifind
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentifind
Source: https://github.com/AvivK5498/Beads-Kanban-UI/tree/main/.claude/skills/agentifind
Command: npx skills add https://github.com/AvivK5498/Beads-Kanban-UI --skill agentifind

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps AI agents understand your codebase's structure, dependencies, and potential dynamic patterns, enabling more efficient and accurate code navigation and analysis.

Core Features & Use Cases

  • Codebase Intelligence: Extracts code structure using LSP (pyright, tsserver) or tree-sitter.
  • Navigation Guide: Synthesizes a CODEBASE.md file for AI agents.
  • Analysis Gaps: Identifies uncalled exports and orphan modules, highlighting areas for manual review.
  • Use Case: Before an AI agent starts refactoring a large Python project, run this Skill to generate a CODEBASE.md that guides the agent to the correct files and functions, significantly reducing exploration time.

Quick Start

Run the agentifind sync command to generate a CODEBASE.md navigation guide for your project.

Frequently Asked Questions about agentifind

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

FAQPage Schema
How do I generate a codebase index for AI agents to navigate?

To generate a codebase index for AI agents, run the sync command to extract code structure using LSP or tree-sitter, producing a codebase.json file and a CODEBASE.md navigation guide. This maps dependencies and call graphs for Python and TypeScript projects.

How does tree-sitter or LSP code analysis work for mapping dependencies?

Tree-sitter and LSP code analysis works by parsing source files to extract code structure, identifying call graphs, import dependencies, and uncalled exports. This process highlights potential dynamic patterns and analysis gaps requiring manual review.

Can I use this code navigation tool with my TypeScript project?

Yes, you can use this code navigation tool with TypeScript projects. It leverages tsserver alongside pyright for Python, extracting call graphs and import dependencies to synthesize a comprehensive CODEBASE.md navigation guide for AI agents.

What is the best way to help an AI agent understand my codebase structure before refactoring?

The best way to help an AI agent understand codebase structure is generating a CODEBASE.md navigation guide. This reduces exploration time by mapping import dependencies, call graphs, and orphan modules, guiding the agent directly to correct files and functions.

Why does code analysis identify uncalled exports and orphan modules?

Code analysis identifies uncalled exports and orphan modules to highlight analysis gaps and potential dynamic patterns. This flags areas requiring manual review, ensuring AI agents understand codebase limitations and avoid missing hidden dependencies during refactoring.

Do I need language servers installed to extract code structure?

You need language servers like pyright or tsserver for deep code structure extraction. Alternatively, the tool uses tree-sitter to parse source files and generate the codebase.json index if LSP servers are unavailable in your environment.