Command Reference
Complete guide to all dora commands
Setup
dora init Initialize dora in your project
dora index Index the codebase (supports --full, --skip-scip, --ignore <pattern>)
dora status Check index health and statistics
Code Exploration
dora map High-level overview: packages, files, symbols
dora ls [dir] List files with metadata (supports --limit, --sort)
dora symbol <query> Search for symbols (supports --kind, --limit)
dora file <path> Analyze a specific file's symbols, dependencies, and tree-sitter metrics
dora refs <symbol> Find all references to a symbol
Tree-sitter Analysis
dora fn <path> List all functions with parameters, return type, async flag, cyclomatic complexity, and LOC. Install a grammar first: bun add -g tree-sitter-typescript
dora class <path> List all classes with extends, implements, decorators, abstract flag, methods, and property count.
dora smells <path> Detect code smells: high complexity, long functions, too many params, TODO/FIXME/HACK comments. Supports --complexity-threshold, --loc-threshold, --params-threshold.
Documentation
dora docs List all documentation files (supports --type for filtering by md/txt)
dora docs search <query> Search through documentation content (supports --limit)
dora docs show <path> Show document metadata and references (supports --content)
Dependencies
dora deps <path> Show dependencies (supports --depth)
dora rdeps <path> Show reverse dependencies (supports --depth)
dora adventure <from> <to> Find shortest path between files
dora exports <path> List exported symbols
dora imports <path> Show file imports
Architecture Analysis
dora cycles Find circular dependencies (supports --limit)
dora coupling Find tightly coupled files (supports --threshold)
dora complexity Show complexity metrics (supports --sort)
dora treasure Find most referenced files and hub files
dora lost Find potentially unused symbols (supports --limit)
dora leaves Find leaf nodes (supports --max-dependents)
Advanced
dora schema Show database schema for custom queries
dora cookbook show [recipe] Query patterns with real examples (quickstart, methods, references, exports)
dora query "<sql>" Execute custom SQL queries (read-only)
dora changes [ref] Show changed files and impact
dora graph <path> Generate dependency graph data
Common Workflows
Initial Setup
Find and Understand Code
Impact Analysis
Architecture Health
Custom Analysis
JSON Output
All commands output valid JSON to stdout. Errors are sent to stderr. This makes dora easy to integrate with AI agents and scripts.