Interactive model selection tool for Claude Code with Synthetic AI models.
synpick is a modern TypeScript/Node.js application that provides a seamless interface for selecting and launching Claude Code with various AI models from the Synthetic API.
npm install -g synpick - available on npm registryNote: The installer script will automatically configure nvm to use Node.js v24.12.0 if available.
Linux/Windows/macOS:
npm install -g synpick
macOS (if permissions error):
sudo npm install -g synpick
Alternative for macOS (permanent fix):
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g synpick
npm install -g https://github.com/jeffersonwarrior/synpick/releases/download/v1.6.1/synpick-1.6.1.tgz
curl -sSL https://raw.githubusercontent.com/jeffersonwarrior/synpick/main/scripts/install.sh | bash
git clone https://github.com/jeffersonwarrior/synpick.git
cd synpick
./scripts/install.sh
Important:
curl -sSL https://raw.githubusercontent.com/jeffersonwarrior/synpick/main/scripts/uninstall.sh | bash
# If installed globally via npm
npm uninstall -g synpick
# If installed locally via npm link
npm unlink -g synpick
# Remove configuration and cache
rm -rf ~/.config/synpick
After installation, run the setup wizard:
synpick setup
This will guide you through:
After setup, you can start using Synpick:
# Launch with interactive model selection
synpick
# Launch with a specific model
synpick --model "openai:gpt-4"
# Browse and save a default model
synpick model
# Check system health
synpick doctor
See USAGE.md for comprehensive usage documentation.
Synpick stores configuration in ~/.config/synpick/config.json. Key options include:
apiKey: Your Synthetic API keybaseUrl: Synthetic API base URLmodelsApiUrl: Models endpoint URLcacheDurationHours: Model cache duration (1-168 hours, default 24)selectedModel: Last selected modelselectedThinkingModel: Last selected thinking modelfirstRunCompleted: Whether first-time setup has been completedmaxTokenSize: Max token size for Claude Code (1000-200000, default 128000)apiTimeoutMs: HTTP API request timeout in ms (1000-300000, default 30000)commandTimeoutMs: Command execution timeout in ms (1000-60000, default 5000)Synpick provides multiple ways to update:
# Update to the latest version
npm update -g synpick
# Check for and install updates from GitHub
synpick update
The update command:
# Install specific version from npm
npm install -g synpick@1.6.1
# Or from GitHub release
npm install -g https://github.com/jeffersonwarrior/synpick/releases/download/v1.6.1/synpick-1.6.1.tgz
synpick --version
You can override configuration with environment variables:
export SYNTHETIC_API_KEY="your-api-key"
export SYNTHETIC_BASE_URL="https://api.synthetic.new"
export SYNTHETIC_CACHE_DURATION=24
git clone https://github.com/jeffersonwarrior/synpick.git
cd synpick
npm install
# Build the project
npm run build
# Run in development mode
npm run dev
# Run tests
npm test
# Run tests with coverage
npm test:coverage
# Lint code
npm run lint
# Format code
npm run format
# Full development cycle
npm run lint && npm test && npm run build
synpick/
├── src/
│ ├── cli/ # CLI commands and parsing (Commander.js)
│ ├── core/ # Application orchestration
│ ├── config/ # Configuration management (Zod)
│ ├── models/ # Data models and API interfaces
│ ├── ui/ # Terminal UI components (Ink)
│ ├── launcher/ # Claude Code launcher
│ ├── api/ # HTTP client (axios)
│ └── utils/ # Shared utilities
├── tests/ # Jest tests
├── scripts/ # Installation and utility scripts
https://api.synthetic.new/openai/v1/modelshttps://api.synthetic.new/anthropicWhen launching Claude Code, Synpick automatically sets:
ANTHROPIC_BASE_URL=https://api.synthetic.new/anthropicANTHROPIC_AUTH_TOKEN={your_api_key}ANTHROPIC_DEFAULT_*_MODEL variantsCLAUDE_CODE_SUBAGENT_MODEL={selected_model}This version includes:
__dirname is not defined and require() errorsnpm install -g synpick# Check your Node.js version
node --version
# Upgrade to Node.js 18+ if needed
nvm install 18
nvm use 18
If synpick command is not found after installation:
# Check if local bin directory is in PATH
echo $PATH | grep -o "$HOME/.local/bin"
# Add to PATH (add to your .bashrc, .zshrc, etc.)
export PATH="$PATH:$HOME/.local/bin"
# Fix npm global permissions
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
# Test API connection
synpick doctor
# Clear cache and retry
synpick cache clear
synpick models --refresh
# Show all commands
synpick --help
# Get help for specific command
synpick models --help
synpick config --help
# Check system health
synpick doctor
git checkout -b feature/amazing-featurenpm test && npm run lintgit commit -m 'Add amazing feature'git push origin feature/amazing-featureThis project is licensed under the MIT License - see the LICENSE file for details.
FAQs
Interactive model selection tool for Claude Code with Synthetic AI models
We found that synpick demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.