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
tanstack create my-app -f              # Force overwrite

Check internet. Or use local:

git clone https://github.com/TanStack/cli.git
cd cli && pnpm install && pnpm build
node packages/cli/dist/index.js create my-app

Some add-ons conflict with each other (e.g., multiple ORMs, multiple auth providers). Use --addon-details <id> to see what conflicts with what:

tanstack create --addon-details clerk

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

tanstack mcp --sse
# Connects at http://localhost:8080/sse

Include when reporting:

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

Links:

• GitHub Issues
• Discord