aztec

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