{"id":44880249,"url":"https://github.com/cuecli/cuecli","last_synced_at":"2026-02-17T16:00:45.547Z","repository":{"id":313299535,"uuid":"1050530237","full_name":"cuecli/cueCLI","owner":"cuecli","description":"AI Prompt Management ","archived":false,"fork":false,"pushed_at":"2025-09-23T22:28:21.000Z","size":203,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-31T10:56:50.124Z","etag":null,"topics":["ai","cli","client","command","interface","line","prompt","prompt-engineering","prompt-injection","prompt-learning","prompt-toolkit","promptengineering"],"latest_commit_sha":null,"homepage":"https://cuecli.com/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cuecli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-04T15:00:43.000Z","updated_at":"2025-10-03T22:33:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"8c2efb98-89d9-448a-8b47-46109b8bb3fe","html_url":"https://github.com/cuecli/cueCLI","commit_stats":null,"previous_names":["cuecli/cuecli"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/cuecli/cueCLI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuecli%2FcueCLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuecli%2FcueCLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuecli%2FcueCLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuecli%2FcueCLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cuecli","download_url":"https://codeload.github.com/cuecli/cueCLI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuecli%2FcueCLI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29549201,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T14:33:00.708Z","status":"ssl_error","status_checked_at":"2026-02-17T14:32:58.657Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","cli","client","command","interface","line","prompt","prompt-engineering","prompt-injection","prompt-learning","prompt-toolkit","promptengineering"],"created_at":"2026-02-17T16:00:44.503Z","updated_at":"2026-02-17T16:00:45.525Z","avatar_url":"https://github.com/cuecli.png","language":"JavaScript","funding_links":["https://www.buymeacoffee.com/akisin"],"categories":[],"sub_categories":[],"readme":"# cueCLI - AI Prompt Management CLI Tool for ChatGPT, Claude \u0026 More\n\n\u003cdiv align=\"center\"\u003e\n\n[![npm version](https://img.shields.io/npm/v/cuecli.svg)](https://www.npmjs.com/package/cuecli)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Node.js Version](https://img.shields.io/node/v/cuecli.svg)](https://nodejs.org)\n\n**Manage, organize, and reuse your AI prompts from the command line**\n\n**🆕 v1.3.101: WCAG \u0026 App Store Compliance Audit prompt now available!**\n\n[🌐 Website](https://cuecli.com) • [📖 Documentation](https://cuecli.com/docs) • [🐛 Issues](https://github.com/cuecli/cueCLI/issues) • [📦 NPM](https://www.npmjs.com/package/cuecli)\n\n\u003c/div\u003e\n\n## 📌 Overview\n\ncueCLI is a 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.\n\n## Why cueCLI?\n\nManaging 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.\n\n**Perfect for:**\n- Developers using ChatGPT, Claude, or other AI assistants daily\n- Teams needing consistent AI interactions across projects\n- Anyone tired of losing or re-writing prompts\n- Prompt engineers building reusable templates\n\n### Key Features\n\n- **Prompt Storage** - Save and organize reusable prompts locally\n- **Instant Retrieval** - Get any prompt to clipboard in under 100ms  \n- **Tag Organization** - Categorize prompts for easy discovery\n- **Variable Substitution** - Create dynamic templates with placeholders\n- **Built-in Sanitization** - Automatically detect and remove sensitive data\n- **Backup System** - Automatic backups of your prompt library\n- **Command Execution** - Optionally execute prompts as shell commands\n- **Cross-platform** - Works on macOS, Linux, and Windows\n\n## Installation\n\n### Via npm (recommended)\n\n```bash\nnpm install -g cuecli\n```\n\n### From source\n\n```bash\ngit clone https://github.com/cuecli/cueCLI\ncd cuecli\nnpm install\nnpm link\n```\n\n## Quick Start\n\n```bash\n# Save a frequently-used prompt\ncuecli add context --from-file README.md --tags project docs\n\n# Get it back instantly (preview → copy)\ncuecli get context\n\n# List all your saved prompts\ncuecli list\n\n# Use variables for dynamic prompts\ncuecli get api-test --vars API_KEY=\"...\" ENV=\"staging\"\n\n# Execute command prompts safely (optional)\ncuecli get deploy-script --execute\n```\n\n## Core Commands\n\n### `cuecli get \u003cname\u003e`\nPreview-first, then copy-first. In TTY, cueCLI shows a numbered preview (default 10 lines), copies the prompt (or prints it with a clear fallback message), and displays a concise directive summary with a single prompt: “Press Enter to continue; press Esc to clear.” In non‑TTY or machine modes, preview/summary are suppressed for clean output.\n\nOptions:\n- `--vars KEY=value...` - Substitute template variables\n- `--stdout` - Print to terminal (in non‑TTY suppresses preview/summary)\n- `--pipe` - Raw output for piping (no preview/summary)\n- `--file \u003cpath\u003e` - Save exact content to file (prints “Saved to \u003cabs_path\u003e”)\n- `--append \u003cpath\u003e` - Append exact content to file (prints “Appended to \u003cabs_path\u003e”)\n- `--preview` / `--lines \u003cn\u003e` - Show preview first; default 10 lines (TTY)\n- `--output \u003cformat\u003e` - json | markdown | html | base64 | url (machine output)\n- `--execute` - Only executes truly executable content (shebang or metadata) with confirm: “About to run this prompt via \u003crunner\u003e. Run? [y/N]”. Non‑executable (Markdown/prose) is hard‑blocked.\n- `--raw` / `--scan-only` - Sanitization controls (see below)\n\n### `cuecli add \u003cname\u003e`\nSave a new prompt to your library. After saving, cueCLI shows preview → copy (or fallback print) → directive summary with a single Enter/Esc prompt in TTY.\n\nOptions:\n- `--from-file \u003cpath\u003e` - Import from file\n- `--from-clipboard` - Import from clipboard  \n- `--desc \u003ctext\u003e` - Set a short description (shown in list)\n- `--tags \u003ctags...\u003e` - Add tags for organization\n\n### `cuecli list`\nDisplay all saved prompts with metadata. In TTY, list is numbered and interactive: type an index to retrieve and see the same preview → copy/summary flow. Non‑TTY shows a non‑interactive snapshot.\n\nOptions:\n- `--tags \u003ctags...\u003e` - Filter by tags\n- `--json` - Output as JSON\n\n### `cuecli edit \u003cname\u003e`\nEdit an existing prompt in your default editor. After saving, cueCLI shows preview → copy (or fallback print) → directive summary with a single Enter/Esc prompt in TTY.\n\nOptions:\n- `--editor \u003ceditor\u003e` - Use specific editor\n- `--desc \u003ctext\u003e` - Update description without opening editor\n\nEditor notes and troubleshooting:\n- cueCLI uses whatever editor command you configure. Set `--editor`, `$EDITOR`, or `~/.cuecli/config.json` key `\"editor\"`.\n- If the editor command is not found, the terminal will show: `Editor command not found: \u003ceditor\u003e` with fixes. Common choices:\n  - macOS built‑in: `--editor 'open -W -e'`\n  - POSIX editors: `--editor nano` or `--editor vim`\n  - VS Code CLI: install the `code` command, then use `--editor 'code -w'`.\n \nTip: When you already have the exact new text, it’s often faster to paste it into your AI assistant and ask it to update the prompt directly (no editor required). Use the terminal for interactive editing or when you prefer your local tools.\n\n### `cuecli export`\nExport your prompt library for backup or sharing. For safety, export asks for a one‑line confirmation before writing.\n\nOptions:\n- `--output \u003cfile\u003e` - Output file path\n- `--raw` - Export without sanitization (includes sensitive data)\n- `--format \u003cformat\u003e` - Output format (json, markdown)\n\n## Template Variables\n\nCreate reusable templates with variables using `{{VARIABLE}}` or `${VARIABLE}` syntax:\n\n```markdown\nProject: {{PROJECT_NAME}}\nEnvironment: ${ENV}\nAPI Endpoint: {{API_URL}}\n```\n\nThen substitute when retrieving:\n```bash\ncuecli get api-template --vars PROJECT_NAME=\"MyAPI\" ENV=staging API_URL=\"https://api.example.com\"\n```\n\n\n## Data Sanitization\n\nProtect sensitive information with built-in sanitization:\n\n```bash\n#!/usr/bin/env bash\n# Scan for sensitive data without modifying\ncuecli get my-prompt --scan-only\n\n# Bypass sanitization (raw)\ncuecli get my-prompt --raw\n\n# Export with or without sanitization (confirm when prompted)\ncuecli export --output shared-prompts.json\ncuecli export --raw --output shared-prompts.json\n```\n\nAutomatically detects:\n- API keys and tokens\n- Passwords and credentials\n- SSH private keys\n- Credit card numbers\n- Email addresses (optional)\n- URLs with embedded credentials\n\n## Configuration\n\ncueCLI stores data in `~/.cuecli/`:\n\n```\n~/.cuecli/\n├── config.json       # Global configuration\n├── prompts.json      # Your prompt library\n├── backups/          # Automatic backups\n└── templates/        # Prompt templates\n```\n\n### Environment Variables\n\n- `CUECLI_CONFIG_DIR` - Override default config directory\n- `EDITOR` - Default editor for prompt editing\n- `LOG_LEVEL` - Set logging level (ERROR, WARN, INFO, DEBUG)\n- `NO_COLOR` - Disable colored output\n\n### Editors \u0026 Troubleshooting\n\n- Default editor resolution order: `--editor` flag → `~/.cuecli/config.json` → `$EDITOR` → `code`.\n- If your editor isn’t found, cueCLI prints actionable fixes (install/configure an editor CLI, use `--editor` once, or set `$EDITOR` / config). No automatic fallback is performed.\n- Recommended defaults:\n  - macOS: `open -W -e` (TextEdit, waits) or `code -w` (VS Code CLI) or `nano`/`vim`.\n  - Linux: `nano`, `vim`, or `vi`.\n  - Windows: `notepad` or a configured editor CLI.\n\nUsing with AI assistants:\n- Editing via an AI assistant is ideal for deterministic updates (e.g., “replace section X with Y”).\n- Running commands is best done directly in your terminal.\n\n## Built-in Universal Prompts\n\ncueCLI comes with 7 universal prompts ready to use:\n\n### 1. Strict Implementation (`strict-implementation`)\nEnsures precise execution without assumptions or creative interpretations.\n```bash\ncuecli get strict-implementation\n```\n\n### 2. QA Simulation (`qa-simulation`)\nComprehensive \"1000 users\" testing audit for finding bugs and UX issues.\n```bash\ncuecli get qa-simulation\n```\n\n### 3. Precision Modification (`precision-modification`)\nSurgical updates to existing systems with zero scope creep.\n```bash\ncuecli get precision-modification\n```\n\n### 4. Change Documentation (`change-documentation`)\nComprehensive documentation standards for all modifications.\n```bash\ncuecli get change-documentation\n```\n\n### 5. Single Screen Review (`single-screen-review`)\nDeep dive analysis of a specific screen or component.\n```bash\ncuecli get single-screen-review\n```\n\n### 6. Progress Tracker (`progress-tracker`)\nComprehensive task tracking and documentation for multi-step projects.\n```bash\ncuecli get progress-tracker\n```\n\n### 7. 🆕 WCAG Compliance (`wcag-compliance`)\nSystematic accessibility audit for WCAG 2.1 Level AA and App Store compliance.\n```bash\ncuecli get wcag-compliance\n```\n\n### Usage Guidelines\n\nThese prompts work best when:\n- You need precise, accountable work with no surprises\n- You're working with existing systems that shouldn't be disrupted\n- You need comprehensive testing or review\n- You require detailed documentation of changes\n- You want to eliminate assumptions and ensure exact execution\n\n## Examples\n\n### Save and Use Project Context\n```bash\n# Add your project README as context\ncuecli add project --from-file ./README.md --tags documentation\n\n# Use it in your AI chat\ncuecli get project\n```\n\n### Create Debug Template\n```bash\n# Create a reusable debug template\necho \"Debug {{SERVICE}} at {{TIME}} with level {{LEVEL}}\" | cuecli add debug --from-clipboard\n\n# Use with different values\ncuecli get debug --vars SERVICE=auth TIME=\"2025-01-04 14:00\" LEVEL=verbose\n```\n\n### Share Sanitized Prompts with Team\n```bash\n# Export without sensitive data\ncuecli export --output team-prompts.json\n\n# Team member imports\ncuecli import team-prompts.json\n```\n\n## Development\n\n### Setup\n```bash\ngit clone https://github.com/cuecli/cueCLI\ncd cuecli\nnpm install\n```\n\n### Testing\nManual smoke checks (preview‑first, copy‑first, guardrails):\n```bash\n# Seed a prompt\ncuecli add strict-implementation --from-file prompts/strict-implementation.md --desc \"Strict-mode directive\"\n\n# List (interactive in TTY)\ncuecli list\n\n# Retrieve (preview → copy/print → summary)\ncuecli get strict-implementation\n\n# Non-executable guard (exit 1)\ncuecli get --execute strict-implementation; echo $?\n```\n\n### Releasing\n- Bump \u0026 tag locally (example: patch release):\n  - `npm version patch -m \"chore(release): %s\"`\n  - `git push origin main --follow-tags`\n- Publish via CI (recommended):\n  - Add repo secret `NPM_TOKEN` (npm Automation token) under GitHub → Settings → Secrets → Actions\n  - Push a tag like `v1.3.99` (created by `npm version`), the Release workflow will:\n    - Install, lint, test\n    - Publish to npm (skips if version already exists)\n    - Create a GitHub Release from the tag\n- Manual publish (optional):\n  - `npm publish --access public`\n  - Then `git tag vX.Y.Z \u0026\u0026 git push origin vX.Y.Z`\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## License\n\nMIT © 2025 Alex Kisin\n\n## Support\n\n- **Documentation**: [cuecli.com/docs](https://cuecli.com/docs)\n- **Issues**: [GitHub Issues](https://github.com/cuecli/cueCLI/issues)\n- **Email**: alex@cuecli.com\n\n## ☕ Support cueCLI\n\nEnjoying cueCLI? Consider buying me a coffee to keep this project going!\n\n\u003ca href=\"https://www.buymeacoffee.com/akisin\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" height=\"50\" width=\"210\"\u003e\n\u003c/a\u003e\n\nYour support helps maintain and improve cueCLI for everyone. Thank you! 🙏\n\n## Acknowledgments\n\nBuilt with:\n- [Commander.js](https://github.com/tj/commander.js/) - CLI framework\n- [Chalk](https://github.com/chalk/chalk) - Terminal styling\n- [Clipboardy](https://github.com/sindresorhus/clipboardy) - Clipboard access\n- [fs-extra](https://github.com/jprichardson/node-fs-extra) - File system utilities\n\n---\n\n✨ **Enjoy cueCLI!** It's been crafted with care to make your AI workflow smoother.  \nIf it's helped you, **star this repo** and share it with others!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcuecli%2Fcuecli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcuecli%2Fcuecli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcuecli%2Fcuecli/lists"}