CLI made for AI agents

dora

the explorer for your codebase

$ grep -r "Logger"

$ dora symbol Logger

Find symbol definitions

Quick Start Documentation

Why dora?

AI coding assistants waste tokens on grep/find/glob to understand code structure. Text-based search gives false positives and misses relationships. dora indexes your codebase so agents can query symbols, dependencies, and references instantly, without reading files.

Steer your AI agent with better alternatives

Typical AI Agent Workflow

With dora

Typical grep and find workflow without dora

Typical AI agent workflow

With dora

# Explore directory structure

tree -L 2 src -I 'node_modules'

# Explore directory structure

dora ls src --sort symbols

# Find what a file exports

grep "^export function" src/db/queries.ts

# Find what a file exports

dora exports src/db/queries.ts

# Count TypeScript files

find src -type f -name "*.ts" | wc -l

# Count TypeScript files

dora ls src

# Search for symbol definitions

grep -r "language" src/converter/ | head -5

# Search for symbol definitions

dora symbol language

# Understand file dependencies

grep -A 10 '"dependencies"' package.json

# Understand file dependencies

dora file src/converter/convert.ts

# Check index status

ls -lh .dora/dora.db

# Check index status

dora status

# Find documentation about a symbol

grep -r "AuthService" docs/ README.md

# Find where symbol is documented

dora symbol AuthService

grep/find/glob work on text patterns. dora understands your code structure.

Quick Start

Language

Platform

1. Install dora

2. Install SCIP indexer

3. Initialize and index your codebase

dora init && dora index

Your codebase is now indexed. Try dora ls to see an overview.

For more installation options, see the documentation.

What your AI agent can do

Find symbols

Locate definitions instantly without reading files or parsing false positives from text search.

Track dependencies

Understand impact before making changes. Know exactly what depends on each file without reading imports.

Find references

See usage across the entire codebase in milliseconds. No more grepping through thousands of files.

Detect cycles

Identify circular dependencies and architectural issues instantly with pre-computed relationship data.

Find unused code

Spot dead code instantly. See which symbols have zero references without scanning every file.

Write custom queries

Answer complex questions about code structure with SQL. No limitations, just structured data.

Search documentation

Find documentation mentioning symbols or files. Link code to docs without manual searching.

How it works

Index

SCIP indexer extracts symbols, definitions, and relationships from your code

Store

dora converts to SQLite with pre-computed aggregates for instant queries

Query

AI agents get structured answers without reading files or wasting tokens

Ready to get started?

Install dora and start exploring your codebase with structured queries.

Get Started View on GitHub