Stats
Links
Categories
CodeDna 🧬
Codebase intelligence engine and AI agent skill.
Point CodeDna at any local directory or remote Git URL. It scans the repository and produces a complete intelligence report — tech stack, architecture, LOC distribution, framework usage, infrastructure, dead code — in milliseconds. Output is both human-readable and machine-readable (JSON), making it the ideal first command for any AI coding agent.
codedna analyze .
codedna analyze https://github.com/vercel/next.js
codedna json . --compact
This repository is primarily a Rust CLI tool. It also ships agent integration files so CodeDna can be used cleanly from Codex, OpenCode, and Claude.
Table of Contents
- Install
- Quick Start
- Commands
- Example Output
- JSON Output
- How It Works
- Git URL Support
- Detection Coverage
- Performance
- AI Agent Skill
- Project Structure
- Contributing
- License
Install CLI
From GitHub
cargo install --git https://github.com/crafteraadarsh/codedna
From Source
git clone https://github.com/crafteraadarsh/codedna
cd codedna
cargo install --path .
Requires Rust stable. Install Rust at rustup.rs.
Verify installation:
codedna --version
Agent Support
CodeDna integrates with agents using their native distribution paths:
Codex: packaged skill inskill/codedna/OpenCode: native skill in.opencode/skills/codedna/Claude: plugin marketplace at.claude-plugin/marketplace.json
Install Codex Skill
If you want Codex to use CodeDna as a real skill, use the dedicated package in skill/codedna/.
skill/codedna/SKILL.mdcontains the trigger description and workflowskill/codedna/agents/openai.yamlcontains Codex UI metadata
Install it with:
./scripts/install-codex-skill.sh
Package it as a distributable tarball with:
./scripts/package-codex-skill.sh
Bootstrap OpenCode And Claude
To copy the OpenCode skill into another repository and add Claude bootstrap guidance:
./scripts/bootstrap-agent-files.sh /path/to/target-repo opencode claude
To install the Codex skill and bootstrap OpenCode plus Claude in one go:
./scripts/bootstrap-agent-files.sh /path/to/target-repo codex opencode claude
Install OpenCode Skill
Install the OpenCode skill globally with:
./scripts/install-opencode-skill.sh
OpenCode also discovers project-local skills from:
.opencode/skills/codedna/SKILL.md
Install Claude Plugin
This repository now includes an official Claude plugin marketplace:
.claude-plugin/marketplace.json
plugins/codedna/.claude-plugin/plugin.json
In Claude Code, install it with:
/plugin marketplace add crafteraadarsh/codedna
/plugin install codedna@codedna-marketplace
Quick Start
# Full intelligence report (local)
codedna analyze .
# Full intelligence report (remote — auto-clones)
codedna analyze https://github.com/vercel/next.js
# JSON for AI agents
codedna json . --compact
# Tech stack only
codedna stack .
# Dead code detection
codedna deadcode https://github.com/user/repo
# Directory tree
codedna map . --depth 3
# Find files using a specific framework
codedna framework react .
Commands
All commands accept a local path or a Git URL.
| Command | Description |
|---|---|
codedna analyze [path|url] | Full intelligence report |
codedna analyze [path|url] --time | Report with elapsed time |
codedna stack [path|url] | Languages, frameworks, databases |
codedna files [path|url] | Per-file LOC breakdown |
codedna framework <name> [path|url] | Files importing a given framework |
codedna deadcode [path|url] | Unreachable / unused files |
codedna map [path|url] | Directory tree |
codedna map [path|url] --depth N | Directory tree limited to N levels |
codedna scan [path|url] | Raw scanned file list |
codedna json [path|url] | Full analysis as JSON |
codedna json [path|url] --compact | Single-line JSON |
codedna json [path|url] --time | JSON with elapsed time |