codedna

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 in skill/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.md contains the trigger description and workflow
• skill/codedna/agents/openai.yaml contains 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