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

$ dora init
$ dora index

Find and Understand Code

$ dora symbol Config
$ dora file src/converter/convert.ts
$ dora refs IndexResult

Impact Analysis

$ dora rdeps src/db/queries.ts --depth 2
$ dora lost --limit 50

Architecture Health

$ dora cycles
$ dora coupling --threshold 10
$ dora complexity --sort complexity

Custom Analysis

$ dora cookbook methods
$ dora query "SELECT kind, COUNT(*) FROM symbols GROUP BY kind"

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.