Build autonomous AI agents that create, deploy, and manage full-stack Solana dApps — using the poof CLI, no custom code needed.

Website · Quick Start · CLI Command Reference · Troubleshooting

This repository contains the Poof skill — a documentation and reference package that teaches AI agents (Claude Code, Cursor, Windsurf, etc.) how to use the Poof platform programmatically via the poof CLI.

Poof is a Backend-as-a-Service for Solana. It generates full-stack dApps (database policies, backend APIs, frontend UI, blockchain operations) from natural language — and this skill gives your AI agent the knowledge to drive that entire lifecycle without a browser.

For AI agents: The skill definition lives in SKILL.md. Detailed docs are in docs/.

Your Agent ──► poof CLI (auth + API + polling built in) ──► poof.new

Your agent runs poof CLI commands to create projects, iterate via chat, run tests, and deploy — all through simple shell commands.

brew install poofdotnew/tap/poof

Or see the poof-cli repo for other install methods. To update later, use brew upgrade poofdotnew/tap/poof for Homebrew installs, or poof update for self-managed binaries.

poof keygen >> .env    # Generate a Solana keypair
poof auth login         # Authenticate

Or if you have existing keys, create a .env:

SOLANA_PRIVATE_KEY=<your-base58-private-key>
SOLANA_WALLET_ADDRESS=<your-solana-public-key>

poof build -m "Build a token-gated voting app where holders can create proposals and vote"

This creates the project, waits for the AI to finish building, and returns the project ID and URLs.

poof iterate -p <project-id> -m "Add a leaderboard page showing top voters"

poof ship -p <project-id>

This repo is designed to be consumed as a skill by AI coding agents.

Clone into your project's .claude/skills/ directory — this makes it available whenever you work in that project and is shareable via git:

cd your-project
git clone https://github.com/poofdotnew/poof-skill.git .claude/skills/poof

Clone to your home directory to make the skill available across all projects:

git clone https://github.com/poofdotnew/poof-skill.git ~/.claude/skills/poof

If you have a plugin marketplace set up, you can install it via Claude Code's /plugin command:

/plugin marketplace add poofdotnew/poof-skill
/plugin install poof@poof-skill

Once installed, just ask Claude Code to build a Poof project — the skill activates automatically on keywords like poof project, deploy dApp, create poof app, poof CLI, poof build, etc.

Example prompts:

> Create a poof project for a token-gated voting app
> Deploy my poof dApp to production
> Build a Solana app with poof that has a bonding curve and leaderboard

Claude Code will handle authentication, project creation, chat-driven iteration, testing, and deployment — all without leaving your terminal.

Point your agent's context/knowledge configuration at the SKILL.md file or the docs/ directory. The skill auto-triggers on the same keywords listed above.

• CLI commands — Complete interface for project lifecycle (build, iterate, deploy, test, download)
• Generation modes — full, policy, backend,policy, ui,policy
• Composite workflows — poof build (create + wait), poof iterate (chat + wait + test results), poof ship (scan + check + deploy)
• Testing workflows — Lifecycle action tests with pass/fail evaluation
• Deployment pipeline — Draft → Preview → Production with security scanning
• Troubleshooting — Common errors and recovery patterns

Switch environments with the --env flag:

poof --env staging build -m "Test my app on staging"

MIT — Copyright (c) 2026 Tarobase, Inc.