Reinstall, Reset & Uninstall

Clean Reinstall

Remove everything and start fresh:
# 1. Stop the gateway
pllan daemon stop

# 2. Remove Pllan + all state
npm uninstall -g pllan
rm -rf ~/.pllan

# 3. Reinstall
curl -fsSL https://pllan.ai/install.sh | bash

# 4. Run onboarding
pllan onboard

Reset Config Only

Keep the installation, reset configuration:
pllan onboard --reset --reset-scope full
Or manually:
rm -rf ~/.pllan/pllan.json
pllan onboard

Reset Sessions Only

Clear all conversation sessions:
rm -rf ~/.pllan/agents/main/sessions
pllan onboard --skip-channels --skip-skills --skip-search

Uninstall

Remove Pllan completely:
# Stop the service
pllan daemon stop
pllan daemon uninstall

# Remove the package
npm uninstall -g pllan

# Remove all data
rm -rf ~/.pllan

Troubleshooting

Gateway won’t start

# Check what's running on the port
pllan daemon status

# Kill stuck processes
pkill -f "pllan-gateway\|node.*dist/entry"

# Restart clean
pllan daemon stop
pllan gateway run

Gateway restart timeout

# Force stop
pllan daemon stop
pkill -9 -f pllan

# Start fresh
pllan daemon start

Plugin errors after update

# Remove installed plugins and reinstall
rm -rf ~/.pllan/extensions
pllan onboard --skip-channels

”command not found” after install

Add npm global bin to your PATH:
# bash
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# zsh (macOS default)
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Wrong Node version

Pllan requires Node 22.16+:
node --version

# Install Node 24 (recommended)
# macOS: brew install node
# Linux: curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash - && sudo apt install -y nodejs