local-dx

DX - Developer Experience Toolkit

A Claude Code plugin for documentation, testing, code review, and workflow automation.

Installation

From local directory

# In Claude Code, run:
/install-plugin /path/to/dx

Development setup

git clone https://github.com/carlonlv/dx.git
cd dx
./scripts/deploy.sh
# Restart Claude Code

Commands

Command	Description
/dx:help	Show plugin documentation and available commands
/dx:lint-test	Run language-aware linters and test suites, generate quality report
/dx:init-claude-md	Initialize CLAUDE.md files recursively across a repo
/dx:pull-commit-pr	Pull latest, update CLAUDE.md files, commit, and create PR
/dx:code-review-docs	Generate comprehensive code review report

/dx:lint-test

Detects project type (Python, Rust, JavaScript, Go, etc.) and runs the appropriate linters and test suites.

/dx:lint-test                  # Run all checks and tests
/dx:lint-test --check-only     # Linters only, skip tests
/dx:lint-test --test-only      # Tests only, skip linters
/dx:lint-test --fix            # Auto-fix lint issues
/dx:lint-test --report         # Generate quality report

/dx:init-claude-md

Recursively creates CLAUDE.md documentation files for each directory in a repository.

/dx:init-claude-md                           # Initialize all directories
/dx:init-claude-md --depth=2                 # Limit depth
/dx:init-claude-md --exclude-folders=vendor  # Skip directories
/dx:init-claude-md --existing=update         # Update existing files
/dx:init-claude-md --dry-run                 # Preview without writing

/dx:pull-commit-pr

End-to-end workflow: pulls latest changes, updates all CLAUDE.md files with current project state, commits, and creates a pull request.

/dx:pull-commit-pr              # Auto-generate branch name
/dx:pull-commit-pr my-branch    # Use custom branch name

/dx:code-review-docs

Analyzes the codebase across multiple dimensions and generates a CODE_REVIEW_REPORT.md.

/dx:code-review-docs                                   # Full review
/dx:code-review-docs --aspects=dead,gaps,simple         # Specific aspects
/dx:code-review-docs --priority=P0,P1                   # Filter by priority
/dx:code-review-docs --top=20                           # Limit findings

Review aspects: architecture, dead code, duplicates, DB queries, implementation gaps, simplifications, TODOs, magic values, deprecated code.

Project Structure

dx/
├── .claude-plugin/          # Plugin configuration
│   ├── plugin.json          # Plugin manifest
│   └── marketplace.json     # Local marketplace config
├── commands/                # Slash commands (/dx:*)
├── agents/                  # Specialized sub-agents
├── changelogs/              # Version history for incremental updates
├── hooks/                   # Pre-commit hooks
└── scripts/                 # Deployment and version management

Development

Deployment

# Reinstall without version change
./scripts/deploy.sh

# Bump version and reinstall
./scripts/deploy.sh patch
./scripts/deploy.sh minor --commit

# Test cache-based installation
./scripts/deploy.sh --cache

See scripts/CLAUDE.md for details on version management and troubleshooting.

Adding a command

Create commands/my-command.md:

---
description: What this command does
allowed-tools: ["Bash", "Read", "Write"]
---

# My Command

Instructions for Claude...

Adding an agent

Create agents/my-agent.md:

---
description: What this agent does
tools: ["Bash", "Read", "Glob", "Grep"]
---

# My Agent

System prompt and instructions...

Requirements

• Claude Code CLI
• jq (for deployment scripts)
• git, gh (for PR workflows)

License

MIT