Quco converts natural language into executable shell commands using AI, right from your terminal. With support for multiple providers, built-in safety validation, and seamless shell integration. It’s like having a command-line memory on demand.
- 🚀 Simple CLI - Just type
quco <your request>and get a shell command - 🧠 Multiple AI Providers - Support for OpenAI, Anthropic, and Google models
- 🔒 Safety First - Never auto-executes commands; validates against destructive patterns
- 📋 Clipboard Integration - Auto-copies commands to clipboard
- ⌨️ Autofill - Optional zsh/bash autofill to load commands into shell buffer
- 📜 Command History - Automatically saves all prompts, responses, and errors for easy reference
- Language - TypeScript
- AI - Vercel AI SDK, Anthropic, Google, OpenAI
- Runtime - Node.js (>= 18.0.0)
- CLI Tools - Commander, Inquirer, Chalk, Ora
npm install -g qucoAfter installation, run the setup:
quco --setupThis will guide you through selecting an AI model provider and entering your API key.
Requirements:
- macOS
- zsh or bash shell
- Node.js >= 18.0.0
After setup, restart your terminal or run:
source ~/.zshrc # or ~/.bashrcThen start generating commands:
# List all JavaScript files
quco list all javascript files in current directory
# Find files modified in last week
quco find files modified in last 7 days
# Process management
quco show all node processes
# Download youtube video
quco "download youtube video https://youtu.be/AbCd"Important: If your prompt contains special characters like ?, *, &, |, or URLs, wrap it in quotes to prevent your shell from interpreting them.
| Command | Description |
|---|---|
--setup |
Interactive setup and configuration. Stores credentials in your shell rc file (.zshrc or .bashrc). |
<prompt> |
Generate a shell command from natural language. The command is printed to stdout and copied to clipboard using pbcopy. |
--version |
Display version information. |
--config |
Show current configuration (model, provider, settings). |
--autofill-on |
Enable autofill for zsh or bash. This loads generated commands into your shell's edit buffer for review. |
--autofill-off |
Disable autofill and remove the shell function from your configuration. |
Quco automatically maintains a history of all command generations in ~/.quco/history.json. The history includes timestamps, prompts, generated commands, and any errors. History is limited to the last 100 entries to prevent excessive disk usage.
Quco automatically creates backups of your shell configuration file (~/.zshrc or ~/.bashrc) whenever it makes modifications during setup or autofill operations. The 3 most recent backups are kept as ~/.zshrc.quco-backup-<timestamp>.
demo.mp4
Note: If the video doesn't load,
▶️ click here to watch the demo
