cueCLI - AI Prompt Management CLI Tool for ChatGPT, Claude & More

📌 Overview

cueCLI is a native command-line tool for managing, organizing, and reusing AI prompts across ChatGPT, Claude, and other assistants. Store frequently-used prompts locally, organize them with tags, and retrieve them instantly. No more copy-pasting from text files or losing prompts in chat history.

Why cueCLI?

Managing prompts across AI chat sessions is messy. Copy-pasting leads to drift, sharing with teams is difficult, and sensitive data needs sanitization. cueCLI solves this by giving you a local prompt library with instant access, smart organization, and built-in safety features. Store once, use everywhere.

Perfect for:

• Developers using ChatGPT, Claude, or other AI assistants daily
• Teams needing consistent AI interactions across projects
• Anyone tired of losing or re-writing prompts
• Prompt engineers building reusable templates

Key Features

• Prompt Storage - Save and organize reusable prompts locally
• Instant Retrieval - Get any prompt to clipboard in under 100ms
• Tag Organization - Categorize prompts for easy discovery
• Variable Substitution - Create dynamic templates with placeholders
• Built-in Sanitization - Automatically detect and remove sensitive data
• Backup System - Automatic backups of your prompt library
• Command Execution - Optionally execute prompts as shell commands
• Cross-platform - Works on macOS, Linux, and Windows

Installation

Via npm (recommended)

npm install -g cuecli

From source

git clone https://github.com/cuecli/cueCLI
cd cuecli
npm install
npm link

Quick Start

# Save a frequently-used prompt
cuecli add context --from-file README.md --tags project docs

# Get it back instantly (copies to clipboard)
cuecli get context

# List all your saved prompts
cuecli list

# Use variables for dynamic prompts
cuecli get api-test --vars API_KEY="..." ENV="staging"

# Execute command prompts safely (optional)
cuecli get deploy-script --execute

Core Commands

cuecli get <name>

Copy a prompt to your clipboard, ready to paste into your AI assistant.

Options:

• --vars KEY=value... - Substitute template variables
• --stdout - Output to terminal instead of clipboard
• --pipe - Clean output for piping
• --file <path> - Save to file instead of clipboard
• --preview - Preview prompt with line numbers
• --execute - Execute prompt as a shell command
• --sanitize - Remove sensitive data before copying

cuecli add <name>

Save a new prompt to your library.

Options:

• --from-file <path> - Import from file
• --from-clipboard - Import from clipboard
• --tags <tags...> - Add tags for organization

cuecli list

Display all saved prompts with metadata.

Options:

• --tags <tags...> - Filter by tags
• --json - Output as JSON

cuecli edit <name>

Edit an existing prompt in your default editor.

Options:

• --editor <editor> - Use specific editor

cuecli export

Export your prompt library for backup or sharing.

Options:

• --output <file> - Output file path
• --sanitize - Remove sensitive data from export
• --format <format> - Output format (json, markdown)

Template Variables

Create reusable templates with variables using {{VARIABLE}} or ${VARIABLE} syntax:

Project: {{PROJECT_NAME}}
Environment: ${ENV}
API Endpoint: {{API_URL}}

Then substitute when retrieving:

cuecli get api-template --vars PROJECT_NAME="MyAPI" ENV=staging API_URL="https://api.example.com"

Data Sanitization

Protect sensitive information with built-in sanitization:

# Scan for sensitive data without modifying
cuecli get my-prompt --scan-only

# Auto-sanitize before copying
cuecli get my-prompt --sanitize

# Export sanitized prompts for sharing
cuecli export --sanitize --output shared-prompts.json

Automatically detects:

• API keys and tokens
• Passwords and credentials
• SSH private keys
• Credit card numbers
• Email addresses (optional)
• URLs with embedded credentials

Configuration

cueCLI stores data in ~/.cuecli/:

~/.cuecli/
├── config.json       # Global configuration
├── prompts.json      # Your prompt library
├── backups/          # Automatic backups
└── templates/        # Prompt templates

Environment Variables

• CUECLI_CONFIG_DIR - Override default config directory
• EDITOR - Default editor for prompt editing
• LOG_LEVEL - Set logging level (ERROR, WARN, INFO, DEBUG)
• NO_COLOR - Disable colored output

Built-in Universal Prompts

cueCLI comes with 6 universal prompts ready to use:

1. Strict Implementation (strict-implementation)

Ensures precise execution without assumptions or creative interpretations.

cuecli get strict-implementation

2. QA Simulation (qa-simulation)

Comprehensive "1000 users" testing audit for finding bugs and UX issues.

cuecli get qa-simulation

3. Precision Modification (precision-modification)

Surgical updates to existing systems with zero scope creep.

cuecli get precision-modification

4. Change Documentation (change-documentation)

Comprehensive documentation standards for all modifications.

cuecli get change-documentation

5. Single Screen Review (single-screen-review)

Deep dive analysis of a specific screen or component.

cuecli get single-screen-review

6. Progress Tracker (progress-tracker)

Comprehensive task tracking and documentation for multi-step projects.

cuecli get progress-tracker

Usage Guidelines

These prompts work best when:

• You need precise, accountable work with no surprises
• You're working with existing systems that shouldn't be disrupted
• You need comprehensive testing or review
• You require detailed documentation of changes
• You want to eliminate assumptions and ensure exact execution

Examples

Save and Use Project Context

# Add your project README as context
cuecli add project --from-file ./README.md --tags documentation

# Use it in your AI chat
cuecli get project

Create Debug Template

# Create a reusable debug template
echo "Debug {{SERVICE}} at {{TIME}} with level {{LEVEL}}" | cuecli add debug --from-clipboard

# Use with different values
cuecli get debug --vars SERVICE=auth TIME="2025-01-04 14:00" LEVEL=verbose

Share Sanitized Prompts with Team

# Export without sensitive data
cuecli export --sanitize --output team-prompts.json

# Team member imports
cuecli import team-prompts.json

Development

Setup

git clone https://github.com/cuecli/cueCLI
cd cuecli
npm install

Testing

npm test              # Run tests
npm run test:watch    # Watch mode
npm run test:coverage # Coverage report
npm run lint          # Lint code

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

MIT © 2025 Alex Kisin

Support

• Documentation: cuecli.com/docs
• Issues: GitHub Issues
• Email: alex@cuecli.com

☕ Support cueCLI

Enjoying cueCLI? Consider buying me a coffee to keep this project going!

Your support helps maintain and improve cueCLI for everyone. Thank you! 🙏

Acknowledgments

Built with:

• Commander.js - CLI framework
• Chalk - Terminal styling
• Clipboardy - Clipboard access
• fs-extra - File system utilities

✨ Enjoy cueCLI! It's been crafted with care to make your AI workflow smoother.
If it's helped you, star this repo and share it with others!