Troubleshooting

# Use npx instead
npx @tanstack/cli create my-app

# Or reinstall globally
npm install -g @tanstack/cli

Use a Node version manager:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20

Requires Node.js 18+:

node --version  # Check
nvm install 20  # Upgrade

tanstack create my-app-v2              # Different name
tanstack create my-app --target-dir ./new/path  # Different path

Check internet. Or use local:

git clone https://github.com/TanStack/cli.git
tanstack create my-app --integrations-path ./cli/integrations

Choose one per group:

• ORM: drizzle | prisma | convex
• Auth: clerk | better-auth | workos
• Lint: eslint | biome
• Deploy: vercel | netlify | cloudflare

cp .env.example .env
# Edit .env with your values
pnpm dev  # Restart

Check .tanstack.json has "tailwind": true and styles.css imports @import 'tailwindcss'.

1. Config location:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Config format:

   json

   {
     "mcpServers": {
       "tanstack": {
         "command": "npx",
         "args": ["@tanstack/cli", "mcp"]
       }
     }
   }
   

3. Restart Claude Desktop completely

lsof -i :8080                    # Check port
tanstack mcp --sse --port 3001   # Use different port

Include when reporting:

• npx @tanstack/cli --version
• node --version
• OS and package manager
• Full error message

Links:

• GitHub Issues
• Discord