Open History to see the last commit
1---
2id: troubleshooting
3title: Troubleshooting
4---
5
6## Installation
7
8### Command not found
9
10```bash
11# Use npx instead
12npx @tanstack/cli create my-app
13
14# Or reinstall globally
15npm install -g @tanstack/cli
16```
17
18### Permission denied
19
20Use a Node version manager:
21
22```bash
23curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
24nvm install 20
25```
26
27### Node too old
28
29Requires Node.js 18+:
30
31```bash
32node --version # Check
33nvm install 20 # Upgrade
34```
35
36## Project Creation
37
38### Directory exists
39
40```bash
41tanstack create my-app-v2 # Different name
42tanstack create my-app --target-dir ./new/path # Different path
43tanstack create my-app -f # Force overwrite
44```
45
46### Add-on fetch failed
47
48Check internet. Or use local:
49
50```bash
51git clone https://github.com/TanStack/cli.git
52cd cli && pnpm install && pnpm build
53node packages/cli/dist/index.js create my-app
54```
55
56### Conflicting add-ons
57
58Some add-ons conflict with each other (e.g., multiple ORMs, multiple auth providers). Use `--addon-details <id>` to see what conflicts with what:
59
60```bash
61tanstack create --addon-details clerk
62```
63
64## Runtime
65
66### Missing env vars
67
68```bash
69cp .env.example .env
70# Edit .env with your values
71pnpm dev # Restart
72```
73
74### Tailwind not working
75
76Check `.tanstack.json` has `"tailwind": true` and `styles.css` imports `@import 'tailwindcss'`.
77
78## MCP Server
79
80### Claude Desktop not connecting
81
821. Config location:
83 - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
84 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
85
862. Config format:
87 ```json
88 {
89 "mcpServers": {
90 "tanstack": {
91 "command": "npx",
92 "args": ["@tanstack/cli", "mcp"]
93 }
94 }
95 }
96 ```
97
983. Restart Claude Desktop completely
99
100### SSE mode
101
102```bash
103tanstack mcp --sse
104# Connects at http://localhost:8080/sse
105```
106
107## Getting Help
108
109Include when reporting:
110- `npx @tanstack/cli --version`
111- `node --version`
112- OS and package manager
113- Full error message
114
115Links:
116- [GitHub Issues](https://github.com/TanStack/cli/issues)
117- [Discord](https://tlinz.com/discord)