CLI Tool

Upgrade your AI
prompts instantly.

Turn rough, rushed instructions into clear, structured prompts — right from your terminal. Powered by Gemini.

View on GitHub npm package ↗
pup — demo
$ pup "fix the auth bug"
Fix the authentication bug in the user session handling logic.
$ pup "add dark mode" --enhance
Implement a dark mode toggle in the application settings page. Add a switch component that allows users to toggle between light and dark themes. Store the user's preference in local storage and apply the appropriate theme on page load.
$ pup "updated the user auth system to use JWT instead of sessions" --short
Switch auth from sessions to JWT.
Installation
$ npm install -g pup-prompt
Requires Node.js 18+
Setup

Get a free API key from Google AI Studio, then set the environment variable.

# bash
echo 'export GEMINI_PUP_API_KEY=your_key' >> ~/.bashrc
source ~/.bashrc

# zsh
echo 'export GEMINI_PUP_API_KEY=your_key' >> ~/.zshrc
source ~/.zshrc
# PowerShell
[System.Environment]::SetEnvironmentVariable('GEMINI_PUP_API_KEY', 'your_key', 'User')

# Command Prompt
setx GEMINI_PUP_API_KEY "your_key"

Restart your terminal after setting the key.

Modes
default
Default
Light cleanup and clarity improvement. Keeps your intent, removes ambiguity.
--enhance
Enhance
Full expansion with detail, edge cases, and structured context.
--short
Short
Strips fluff. Condenses your prompt to its essential instruction.
--fix
Fix
Typos and grammar only. Content stays untouched.
Features
Examples
in
login not working
out
Fix the login functionality that is currently not working.
in
add dark mode to settings page --enhance
out
Implement a dark mode toggle in the application settings page. Add a switch component that allows users to toggle between light and dark themes. Store the user's preference in local storage and apply the appropriate theme on page load.
in
updated the user authentication system to use JWT tokens instead of sessions --short
out
Switch auth from sessions to JWT.
Works with
GitHub Copilot Claude Code Cursor ChatGPT Codex Any AI tool

Start writing better prompts.

One install. No config. Works immediately.

View on GitHub npm ↗