rust-lsp CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

A Claude Code plugin providing Rust development support through rust-analyzer LSP integration and 18 automated hooks for code quality, security, and dependency analysis.

Setup

Run /setup to install all required tools, or manually:

rustup component add rust-analyzer
rustup toolchain install nightly
cargo install cargo-audit cargo-deny cargo-outdated cargo-machete \
              cargo-semver-checks cargo-geiger cargo-expand cargo-bloat \
              cargo-mutants
cargo +nightly install cargo-udeps

Key Files

File	Purpose
.lsp.json	rust-analyzer LSP configuration
hooks/hooks.json	18 automated development hooks
commands/setup.md	/setup command definition
.claude-plugin/plugin.json	Plugin metadata

Hook System

Hooks trigger on PostToolUse for Write/Edit operations. Designed to be fast and non-blocking.

What hooks execute (instant):

• .rs files: rustfmt (single file), grep for unsafe/TODO/FIXME
• .md files: markdownlint (if available)
• Cargo.toml/Cargo.lock: hints only (no cargo execution)

On-demand commands (shown as hints, run manually):

• cargo check && cargo clippy && cargo test
• cargo audit && cargo outdated --depth 1
• cargo machete (find unused deps)

When Modifying Hooks

Edit hooks/hooks.json. Each hook follows this pattern:

{
    "name": "hook-name",
    "event": "afterWrite",
    "hooks": [{ "type": "command", "command": "..." }],
    "matcher": "**/*.rs"
}

• Use || true to prevent hook failures from blocking writes
• Use head -N to limit output verbosity
• Use command -v tool >/dev/null && for optional tool dependencies

When Modifying LSP Config

Edit .lsp.json. The extensionToLanguage map controls which files use the LSP. Current config maps .rs files to the rust language server.