AI Toolkit

Overview

The AI Toolkit is a standardized collection of AI agents and commands designed for Claude Code workflows. Its goal is to allow anyone at Uniswap to install and configure Claude Code to be maximally useful, all in a single command (npm run start)

What it provides:

• One-shot Installation: Automated setup of Claude Code configurations
• Pre-built AI Agents: Specialized subagents for code explanation, refactoring, testing, research, and more. Claude Code will use these automatically without any need for manual direction by the user
• Ready-to-use Commands: Quick access patterns (called "Slash commands") for common development workflows like understanding codebases (/explore), generating tests (/gen-tests), and planning features (/plan)
• Standardized Patterns: Create a common toolset of Claude Code commands and agents shared by everyone at Uniswap

Why it exists:

Instead of each person at Uniswap manually configuring AI assistant behaviors for each project, the AI Toolkit provides curated, tested configurations that can be installed instantly. This makes AI-assisted development more consistent, efficient, and accessible to Uni teams.

Getting Started

Before working with this repository, ensure you have the following tools installed:

• Node.js 22+ with npm

Local Installation

# Clone the repository
git clone https://github.com/Uniswap/ai-toolkit
cd ai-toolkit

# Install all dependencies (also sets up git hooks automatically)
npm install

Setup Claude Code Integration

Option A: Install Everything (Recommended)

# Run the CLI to show you everything you can install. Start with the 'init' and then 'hooks' to get started
npm run start

and you should see the CLI options below:

Option B: Selective Installation

# Install just the notification hooks
npx nx generate @uniswap/ai-toolkit-nx-claude:hooks

# Or preview what would be installed (dry-run mode)
npx nx generate @uniswap/ai-toolkit-nx-claude:init --dry-run

Verify Installation

# Make sure you have Claude Code installed, and that the agents + commands are available when you run `claude`

claude # this should open up the Claude Code REPL

# executing the "/agents" slash command should show that multiple agents have been installed
> /agents

# you should see custom /slash commands, such as "/plan", are now available to you in your Claude Code REPL.
> /plan

Once installed, you'll have access to powerful Claude Code agents and commands that make development workflows more efficient and consistent.

Contributing

We welcome contributions from all developers! This project uses a trunk-based development workflow with automated publishing. Please read our Contributing Guide for detailed information about:

• Branch strategy (main for stable, next for active development)
• Development workflow and best practices
• Code quality standards and testing requirements
• Automated publishing to private @uniswap/ai-toolkit-nx-claude NPM registry

Quick Start for Contributors

1. Setup your environment:

   git clone https://github.com/Uniswap/ai-toolkit
   cd ai-toolkit
   npm install  # Sets up everything including git hooks

2. Install recommended tools:

   • Nx Console for your IDE (VSCode, Cursor, or IntelliJ)

   • MCP server for AI assistance:

     claude mcp add nx-mcp npx nx-mcp@latest --scope user

3. Create your feature:

   git checkout next
   git checkout -b feature/your-feature
   # Make changes, then create PR to 'next' branch

For complete contribution guidelines, see CONTRIBUTING.md.

Development Workflow

This repository follows a structured development and release workflow:

Branches

• main: Stable, production-ready code (publishes with @latest tag)
• next: Feature integration and testing (publishes with @next tag)
• feature/*: Individual feature branches (not published)

Package Versions

Our packages are available in two release channels:

# Install stable version (from main branch)
npx @uniswap/ai-toolkit-nx-claude@latest

# Install prerelease version (from next branch)
npx @uniswap/ai-toolkit-nx-claude@next

Automated Features

• Automated Publishing: Packages are automatically published when changes merge to main or next
• Version Management: Conventional commits automatically determine version bumps
• Branch Synchronization: next is automatically rebased onto main after stable releases
• Code Quality: Pre-commit hooks ensure consistent formatting and linting

Run tasks

To build the library use:

npx nx build pkg1

To run any task with Nx use:

npx nx <target> <project-name>

These targets are either inferred automatically or defined in the project.json or in the nx property of package.json files.

More about running tasks in the docs »

Versioning and releasing

This is done automatically in the CI on pushes to main.

Checkout the ci-publish-packages.yml workflow file for more information.

Learn more about Nx release »

Keep TypeScript project references up to date

Nx automatically updates TypeScript project references in tsconfig.json files to ensure they remain accurate based on your project dependencies (import or require statements). This sync is automatically done when running tasks such as build or typecheck, which require updated references to function correctly.

To manually trigger the process to sync the project graph dependencies information to the TypeScript project references, run the following command:

npx nx sync

You can enforce that the TypeScript project references are always in the correct state when running in CI by adding a step to your CI job configuration that runs the following command:

npx nx sync:check

Learn more about nx sync

Automated Package Publishing

The repository uses sophisticated CI/CD automation for package publishing:

Publishing Pipeline

Our automated workflow (.github/workflows/ci-publish-packages.yml) handles:

• Dual-branch publishing:
  • main → stable releases (@latest tag)
  • next → prerelease versions (@next tag)
• Intelligent versioning: Conventional commits drive automatic version bumps
• Independent packages: Each package versions independently based on changes
• NPMJS registry: GitHub Actions CI publishes packages to a private npmjs registry

How It Works

1. Feature Development (on next branch):

   git commit -m "feat: amazing new feature"
   git push origin next
   # Automatically publishes as 1.0.0-next.0

2. Stable Release (merged to main):

   # After testing on next, merge to main
   # Automatically publishes as 1.0.0

3. Branch Synchronization:

   • After main publishes, next automatically rebases
   • Keeps development branch current with stable changes
   • Conflicts create GitHub issues for manual resolution

For technical details, see DEVELOPMENT.md.

Install Nx Console

Nx Console is an editor extension that enriches your developer experience. It lets you run tasks, generate code, and improves code autocompletion in your IDE. It is available for VSCode and IntelliJ.

Install Nx Console »

Useful Nx links

Learn more:

• Learn more about this workspace setup
• Learn about Nx on CI
• Releasing Packages with Nx release
• What are Nx plugins?

And join the Nx community:

• Discord
• Follow us on X or LinkedIn
• Our Youtube channel
• Our blog