is-equal/claude-dx

claude-dx starts Claude Code with the dx tools: skills, an MCP server and hooks for ADRs, tasks, learnings, a glossary, git, files and LSP servers. The tools do the mechanical work, so the model uses fewer tokens and gives the same result each time.
claude-dx writes no configuration into your project or into your Claude Code settings. It loads its plugin with launch flags.
> Status: in development. See docs/tasks/.
## Why
An AI agent spends many tool calls and tokens on mechanical work: read a template, find the next number, write a file, update an index, adapt a shell command to the platform. Each call sends the full context again, and each run can give a different result.
claude-dx moves this work into Go tools:
Fewer tokens. One tool call does what took many. Results are compact text.
Consistency. The same operation gives the same result each time, on macOS, Linux and Windows.
Safe defaults. Rebase, Conventional Commits, no force push to the main branch without your direct approval.
Clear documents. ADRs, tasks, learnings and the glossary use ASD-STE100 Simplified Technical English. You talk to the agent in your language.
## Roadmap
Each task has a milestone field. The task index has one table for each milestone.
| Milestone | Content |
| v0.1.0 | Launcher, update, cache clean, doctor. Tools and skills for ADRs, tasks, learnings and the glossary. /dx:grill and the scout agent. |
| v0.2.0 | Git tools, the Bash git block, gitexec, report. /dx:commit and /dx:eureka. |
| v0.3.0 | Filesystem tools. |
| v0.4.0 | LSP servers with a warm cache for Go, TypeScript, JavaScript, Python, C and C++. No install by the user. |
| v0.5.0 | LSP servers for HTML, CSS, JSON, Bash, CMake, Lua, Make and Ninja. |
## Install
macOS and Linux:
sh
curl -fsSL https://raw.githubusercontent.com/EqualSoftware/claude-dx/main/scripts/install.sh | sh
Windows (PowerShell):
powershell
irm https://raw.githubusercontent.com/EqualSoftware/claude-dx/main/scripts/install.ps1 | iex
The scripts verify the SHA-256 checksum of the release. To change the install directory, set CLAUDEDXINSTALLDIR.
Each release file has a GitHub build provenance attestation. It proves that the release workflow of this repository made the file. To verify a file that you downloaded, use the GitHub CLI:
sh
gh attestation verify claude-dx .tar.gz --repo EqualSoftware/claude-dx
## Use
sh
claude-dx [claude arguments] # Start Claude Code with dx.
claude-dx -- [claude arguments] # Pass all arguments to Claude Code.
claude-dx update # Install the latest release.
claude-dx cache clean # Remove all data of claude-dx.
claude-dx doctor # Check the setup.