cursorrules— rules

 ██    ██ ██ ██████  ███████ ██   ██ ██ ████████
 ██    ██ ██ ██   ██ ██      ██  ██  ██    ██
 ██    ██ ██ ██████  █████   █████   ██    ██
  ██  ██  ██ ██   ██ ██      ██  ██  ██    ██
   ████   ██ ██████  ███████ ██   ██ ██    ██

VibeKit gives your AI the skills and tools to build on Algorand with one command.

Works with Claude Code, OpenCode, Cursor, and VS Code / Copilot.

Note: VS Code Copilot's "Agent Skills" feature is experimental and disabled by default. Enable it in Settings (search "agentskills"). For best results, use Claude Code or another dedicated coding agent.

Early release — feedback welcome.

Quick Start

Install VibeKit:

curl -fsSL https://getvibekit.ai/install | sh

Windows (alpha):

# Install the Visual C++ Redistributable (required for OS keyring support)
winget install Microsoft.VCRedist.2015+.x64

# Install VibeKit
$env:VIBEKIT_CHANNEL = "alpha"; irm https://getvibekit.ai/install.ps1 | iex

Run the setup wizard:

vibekit init

Verify setup:

vibekit status

Open your AI tool and start building.

Platform Support

Why VibeKit

AI coding assistants are bad at Algorand. They hallucinate APIs, use outdated patterns and tools, and can't actually deploy or test anything.

vibekit init fixes this. It detects your AI tools and installs two things: skills that teach your AI current Algorand patterns, and MCP tools that let it interact with the blockchain directly.

Now your AI can build a marketplace contract, deploy it to LocalNet, create test assets, call methods, and verify state. Need to debug? Just ask and it pulls the indexer logs for you.

Keys stay safe. Account providers (Vault or OS Keyring) handle signing without exposing secrets to the AI.

Documentation

Full documentation at [getvibekit.ai](https://getvibekit.ai)

• Installation
• Quick Start
• How It Works
• CLI Reference

CLI Commands

vibekit init               # Interactive setup wizard
vibekit status             # Show component status
vibekit mcp                # Run MCP server (for IDE integration)
vibekit remove             # Remove VibeKit configs

vibekit vault <cmd>        # Manage HashiCorp Vault
vibekit account <cmd>      # Dangerous account operations
vibekit dispenser <cmd>    # TestNet Dispenser auth

vibekit --version          # Show version
vibekit --help             # Show help

Development

See AGENTS.md for development guidance.

bun install          # Install dependencies
bun run build        # Build all packages
bun run typecheck    # Type check
bun run dev:cli      # Run CLI from source

License

MIT