Getting Started

Polter is an interactive CLI orchestrator that unifies four developer tools — Supabase, GitHub (gh), Vercel, and Pulumi — into one discoverable interface. Instead of memorizing command trees across multiple CLIs, you browse a tabbed board, pick args interactively, attach flags, and pin common workflows for reuse.

Installation

Run one-off without installing

npx @polterware/polter@latest

Install in a repository

npm install -D @polterware/polter

Then run it from that repository:

npx polter

Install globally

npm install -g @polterware/polter

Then run:

polter

Use a repository install when you want the CLI version pinned to one project. Use a global install when you want the same CLI version across every repository.

Update

If installed globally:

npm install -g @polterware/polter@latest

If installed in a repository:

npm install -D @polterware/polter@latest

You can also update from inside Polter — go to Actions > Update Polter and choose repository or global.

Requirements

• Node.js >= 18

CLI tools are optional. Polter detects which ones are installed and shows their status on the Tool Status screen:

• Supabase CLI — Install guide
• GitHub CLI (gh) — Install guide
• Vercel CLI — Install guide
• Pulumi CLI — Install guide

Check your environment:

node -v
supabase --version
gh --version
vercel --version
pulumi version

Typical Flow

1. Choose a command from the board
2. Optionally pin/unpin with →
3. Choose suggested args or type custom extra args
4. Pick optional flags
5. Confirm and execute

Next Steps