eye CLI
v0.17.0Know exactly what breaks before you push. Blast radius analysis, breaking change detection, dead code scanning, and cross-repo symbol indexing — all in one CLI.
Everything you need to refactor safely
Six focused capabilities, built for the moments right before you change something important.
Blast Radius Analysis
Run eye <file>:<symbol> to trace every caller and importer of any symbol across the codebase. Output in JSON or human-readable format.
Breaking Changes Detection
Run eye breaking-changes to detect function-signature breakages between two git refs before they reach production.
Dead Code Scanner
Run eye dead-code to find exported symbols with zero consumers. CSS mode scans directly without a database.
Cross-Repo Index
Use eye registry build to scan an entire Gitea org and build a SQLite index. Query symbol dependencies across repos with eye registry query.
MCP Server
Launch eye-mcp to expose blast_radius and explain_callers tools via the MCP protocol. AI agents like Claude Code automatically know the impact scope before refactoring.
Full CSS/SCSS Support
CSS classes, CSS variables, cn()/clsx(), @keyframes, @mixin, and %placeholder are all blast-radius-aware. Accumulated across v0.15–v0.17.
10 languages, one tool
eye understands the import and call semantics of each language natively — no plugin configuration required.
Simple commands, powerful insights
All eye capabilities are exposed as clean CLI subcommands.
# Blast radius — trace all callers of a symbol $ eye src/auth/token.ts:verifyToken # Analyse staged changes before commit $ eye detect-changes --staged # Detect API breaking changes between two refs $ eye breaking-changes main HEAD # Find dead code — exported symbols with zero consumers $ eye dead-code # Build cross-repo symbol index for a Gitea org $ eye registry build # Expand multi-hop call chain for a symbol $ eye explain UserService # Start MCP server for AI agent integration $ eye-mcp
Platform support
Prebuilt binaries for macOS and Linux. No Windows build — eye depends on ripgrep which is not yet ported to Windows.
Start free, stay free for small teams
14-day full-feature trial, no credit card required. After trial ends, choose the plan that fits you.
- All 6 core features unlocked
- MCP Server included
- Expires automatically after 14 days
- No account required
- 10 queries per day
- All features accessible
- Single repository
- Unlimited queries
- Cross-repo registry (multi-repo)
- MCP Server + CI/CD integration
- Priority support