Stop memorizing commands. Start shipping.
A blazing-fast command palette for your terminal with multi-provider AI intelligence.
brew install GLINCKER/palrun/palrunWorks on Mac, Windows, and Linux.
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β PALRUN [rust] main β β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β > build β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β β cargo build Build the project β
β cargo build --release Build optimized binary β
β npm run build Bundle frontend β
β make build Run makefile target β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β ββ navigate β execute tab preview esc quit β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
"Finally stopped grepping through package.json to find scripts."
"The AI diagnostics saved me 2 hours debugging a cryptic npm error."
"Just type 3 letters and hit enter. That's it."
Why Palrun Β· Install Β· How It Works Β· AI Features Β· Commands
Every project has commands scattered everywhere. npm scripts in package.json. Cargo commands in Cargo.toml. Make targets. Docker compose. Task runners. You end up:
- Scrolling through 50 npm scripts to find the right one
- Forgetting that obscure cargo command you used last week
- Grepping through config files looking for targets
- Context-switching to docs constantly
Palrun fixes this. It scans your project, finds every command, and gives you a fuzzy-searchable interface. Type 2-3 characters, hit enter, done.
The AI features are optional but powerful β generate commands from natural language, explain what complex commands do, diagnose errors without leaving your terminal.
# Homebrew (macOS/Linux) - Recommended
brew install GLINCKER/palrun/palrun
# Cargo
cargo install palrun
# NPM
npm install -g @glincker/palrun
# Download binary
# https://github.com/GLINCKER/palrun/releasesThen just run:
palrunPalrun scans your project and finds commands from:
| Source | Files | What It Finds |
|---|---|---|
| Node.js | package.json |
npm/yarn/pnpm/bun scripts |
| Rust | Cargo.toml |
cargo build, test, run, clippy |
| Go | go.mod |
go build, test, run |
| Python | pyproject.toml |
pytest, poetry, pdm commands |
| Make | Makefile |
All make targets |
| Docker | docker-compose.yml |
compose up/down/logs |
| Task | Taskfile.yml |
task commands |
| Monorepos | nx.json, turbo.json |
nx/turbo commands |
Type a few characters, palrun finds the match:
buiβcargo buildtdβnpm run test:debugdcuβdocker compose up
Powered by nucleo β the same engine behind Helix editor.
Commands are ranked by proximity to your current directory. Working in src/api/? API-related commands appear first.
Palrun supports multiple AI providers with automatic fallback:
| Provider | API Key Env Var | Best For |
|---|---|---|
| Claude | ANTHROPIC_API_KEY |
Complex reasoning |
| OpenAI | OPENAI_API_KEY |
Fast, general purpose |
| Azure OpenAI | AZURE_OPENAI_API_KEY |
Enterprise deployments |
| Grok | XAI_API_KEY |
Alternative option |
| Ollama | None (local) | Offline, privacy |
palrun ai "run tests with coverage"
# β cargo test --all-features -- --nocapturepalrun ai explain "git rebase -i HEAD~5"
# Explains what interactive rebase doespalrun ai diagnose "npm ERR! peer dep missing: react@18"
# Suggests: npm install react@18 --save-peerSet keys via environment variables or config file:
# Environment (recommended)
export ANTHROPIC_API_KEY="sk-ant-..."
# Or in ~/.config/palrun/palrun.toml
[ai.claude]
api_key = "sk-ant-..."palrun # Launch TUI
palrun list # List all commands
palrun list --json # JSON output for scriptingpalrun exec build # Run by name
palrun exec "npm test" # Run specific command
palrun exec build -y # Skip confirmationpalrun setup # Initialize for your project
palrun setup --dry-run # Preview changesGenerate slash commands for AI coding tools:
palrun slash generate claude # For Claude Code
palrun slash generate cursor # For Cursor
palrun slash generate aider # For AiderAdd keyboard shortcuts to your shell:
# Bash
eval "$(palrun init bash)"
# Zsh
eval "$(palrun init zsh)"
# Fish
palrun init fish | source
# PowerShell
palrun init powershell | Invoke-ExpressionCreate ~/.config/palrun/palrun.toml:
[general]
confirm_dangerous = true
[ui]
theme = "default"
show_preview = true
show_icons = true
[ai]
provider = "claude"
fallback_enabled = true
[ai.claude]
model = "claude-sonnet-4-20250514"For API keys, use environment variables or the system config file β never commit secrets to your repo.
| Alternative | Palrun Advantage |
|---|---|
cat package.json | jq |
One command, fuzzy search, instant |
| fzf + custom scripts | Zero setup, auto-discovers everything |
| IDE command palette | Works in terminal, any project type |
| Memorizing commands | You have better things to remember |
For AI tools: Pre-computed command index saves ~1500 tokens per query. AI doesn't need to scan your project.
# Build
cargo build --release
# Test (527 tests)
cargo test --all-features
# Run locally
cargo run -- listLocal quality gates (auto-installed):
./.githooks/install.sh
# pre-commit: format, clippy, build
# pre-push: tests, security audit
# commit-msg: conventional commits- Multi-provider AI (Claude, OpenAI, Azure, Grok, Ollama)
- Agentic workflow system
- IDE slash command generation
- Hierarchical config with secrets management
- MCP server mode for AI agents
- Chat history and session persistence
- Streaming AI responses
- VS Code extension
Contributions welcome! See CONTRIBUTING.md.
git clone https://github.com/GLINCKER/palrun.git
cd palrun
cargo test
cargo runMIT License β free for personal and commercial use.
Your terminal has hundreds of commands. Palrun finds the right one instantly.
GitHub Β· Issues Β· Discussions
Built by GLINCKER