Aztec Plugin for Claude Code
A Claude Code plugin for Aztec smart contract and application development. This plugin provides specialized agents, skills, and commands to help you build privacy-preserving applications on the Aztec Network.
⚠️ This plugin defaults to Aztec version v4.2.0-aztecnr-rc.2. See Switching Versions to use a different version.
Installation
Option 1: Install from Marketplace (Recommended)
/plugin marketplace add critesjosh/aztec-claude-plugin
/plugin install aztec@aztec-plugins
Option 2: Load from directory (Development)
Clone the repository and load directly:
git clone https://github.com/critesjosh/aztec-claude-plugin
claude --plugin-dir /path/to/aztec-plugin
Updating
Marketplace installs
/plugin marketplace update
Local installs
cd /path/to/aztec-plugin
git pull
Changes take effect on the next Claude Code session.
Network Versions
This plugin supports multiple Aztec network versions with potentially different syntax. Switch between them based on your target deployment:
# Clone with a specific network version
git clone https://github.com/critesjosh/aztec-claude-plugin
cd aztec-plugin
./setup.sh testnet # or: mainnet, devnet
Available Networks
| Network | Description | Use Case |
|---|
mainnet | Stable production release | Production deployments |
testnet | Pre-release testing | Integration testing |
devnet | Latest development | Experimenting with new features |
Switching Networks
# Switch to a different network
./setup.sh devnet
# Check current network
./setup.sh status
See NETWORK.md for detailed version differences.
Aztec MCP Server
This plugin includes the @aztec/mcp-server which provides local access to Aztec documentation, examples, and source code.
Features
- Repository Cloning - Clones aztec-packages, aztec-examples, and aztec-starter locally
- Code Search - Regex-based search across Noir contracts and TypeScript files
- Documentation Search - Search Aztec docs by section
- Example Discovery - List and read example contracts
Switching Versions
The plugin defaults to a specific Aztec version. To switch versions:
Option 1: Use the /aztec-version command
/aztec-version # Autodetect from project's Nargo.toml
/aztec-version v3.0.0-devnet.7 # Use specific version
The command will automatically detect the Aztec version from your project's Nargo.toml if no version is specified.
Option 2: Call aztec_sync_repos directly
aztec_sync_repos({ version: "v3.0.0-devnet.7", force: true })
Check current version:
aztec_status()
Find available versions at aztec-packages tags.
Features
Slash Commands
| Command | Description |
|---|
/aztec:new-contract <name> | Create a new Aztec contract with boilerplate |
/aztec:review-contract <path> | Review a contract for best practices |
/aztec:add-function <description> | Add a new function to an existing contract |
/aztec:add-test <description> | Add a test for a contract function |
/aztec:explain <concept> | Explain an Aztec concept or pattern |
/aztec:deploy <contract> | Generate a TypeScript deployment script |
/aztec:generate-client <contract> | Generate a TypeScript client class |
/aztec-version <version> | Switch the Aztec version for MCP server |
Agents
Contract Reviewer (contract-reviewer)
- Reviews Aztec contracts for correctness and best practices
- Checks private/public function usage
- Identifies common issues and anti-patterns
Security Auditor (security-auditor)
- Performs security audits on Aztec contracts
- Identifies privacy vulnerabilities
- Detects ZK-specific security issues
Skills
Aztec Developer (aztec-developer)
- Framework-specific knowledge that prevents hallucinations (Noir overflow semantics, note randomness, storage indexing)
- Contract structure, storage, notes, cross-contract calls
- TXE unit testing patterns
- Privacy patterns (
enqueue_incognito, pop_notes vs get_notes)
- Based on aztec-claude-skill
Contract Review (review-contract)
- Structured security review with severity levels
- Aztec-specific pitfall checklist (note ownership, privacy leaks, msg_sender)
- "What's Done Well" positive feedback section
- MCP server verification of patterns
critesjosh