Solana AI Kit
Production-ready Claude Code configuration for full-stack Solana development. Combines best practices from multiple sources into an agent-optimized, token-efficient config you can install and adapt to your specific project.
The idea here is to provide a generic CLAUDE.md that relies on subagents to plan and execute actions, dynamically loading markdown files, saving tokens and context in the end of the day. This config fully leverages the official Claude Code config recommendations:
- Rules are only loaded whenever specific file types are involved;
- SKILL.md is a mega hub to dynamically-disclosed skill files that are directly fetched from the best skill repos distributed across the ecosystem (Solana Foundation, Colosseum, Solana Mobile, SendAI, etc);
- Plus, its CLAUDE-solana.md is than half the size of the usual CLAUDE.md, leaving space for its self improvements programmed into the agents, noting and learning from anti-patterns, errors, recurrency and more. For less important notes, CLAUDE.local.md is constantly maintained by agents as well and, on monorepos, per-folder CLAUDE.md is also maintained.
Current multi-agent workflow favors monorepos, so we use a single CLAUDE.md/config for the whole project while leveraging agents and context-specific skills to solve each step of builder flow.
If you installed manually, remember to rename ./CLAUDE-solana.md back to ./CLAUDE.md, as the current top-level CLAUDE.md file is focused on maintaining the repo itself.
What This Is
A complete .claude/ configuration that turns Claude into a Solana development expert with:
- 15 specialized agents for different tasks (architecture, Anchor, Pinocchio, DeFi, tokens, frontend, mobile, backend, DevOps, QA, docs, games, Unity, learning, research)
- 29 workflow commands for building, testing, deploying, profiling, migrating, and committing
- 7 MCP server integrations for on-chain data (Helius), Solana docs (solana-dev), library docs (Context7), browser automation (Playwright), context optimization (context-mode), persistent memory (memsearch), and local-validator / mainnet-fork control (Surfpool)
- Agent teams for multi-step workflows (architect → engineer → QA)
- Progressive skill loading that only loads context when needed (saves tokens)
- Auto-loading rules that enforce best practices based on file patterns
Quick Start
# Option 0: Fork Template (Github UI)
claude -m "/cleanup" # then start claude code running /cleanup so top-level directory of your project isn't polluted
# Option 1: One-liner installer (Claude Code)
curl -fsSL https://aikit.superteam.codes | bash
# Fallback (or before the aikit.superteam.codes DNS is live): curl -fsSL https://raw.githubusercontent.com/solanabr/solana-ai-kit/main/install.sh | bash
# Option 2: One-liner installer (Codex, Opencode, everything else)
curl -fsSL https://aikit.superteam.codes | bash -s -- --agents
# Fallback (or before the aikit.superteam.codes DNS is live): curl -fsSL https://raw.githubusercontent.com/solanabr/solana-ai-kit/main/install.sh | bash -s -- --agents
# Option 3: Manual setup
git clone --recurse-submodules https://github.com/solanabr/solana-ai-kit.git
cp -r solana-ai-kit/.claude /path/to/your-project/
cp solana-ai-kit/CLAUDE-solana.md /path/to/your-project/CLAUDE.md
cd /path/to/your-project && git submodule update --init --recursive
# Option 4: Claude Code plugin (run inside Claude Code)
/plugin marketplace add solanabr/solana-ai-kit
/plugin install solana-ai-kit@stbr
# Commands then namespace as /solana-ai-kit:<name>. The plugin is the CORE kit
# (agents/commands/local skills/MCP/hooks); the curl one-liner (Option 1) is the
# FULL install, adding rules + permissions/sandbox + the 18 ext/ submodules.
# Details: see "Install as a Claude Code plugin" below.
# Start Claude Code
claude
--agents Flag
Pass --agents to install everything into .agents/ instead of .claude/. Same content, different directory name. Useful when .claude/ is already taken or for non-Claude AI tools (Cursor, Windsurf, Copilot, etc.).
bash install.sh --agents /path/to/your-project
To update an --agents install:
# Run from your project root:
bash .agents/bin/update.sh
MCP Setup (Optional)
After installation, configure MCP servers for enhanced capabilities:
