Clio - AI CLI Assistant for VS Code

Clio is a VS Code extension that helps you generate and execute CLI commands using natural language. Simply describe what you want to do, and Clio will suggest the appropriate command.

Features

• Generate CLI commands from natural language descriptions
• Directly execute suggested commands in your terminal
• Safety ratings for each command with confirmation for potentially destructive operations
• Works with git, Docker, Node.js, and general terminal commands
• Automatic terminal detection and initialization
• Command palette integration with keyboard shortcut (Ctrl+Shift+C / Cmd+Shift+C)
• Terminal link provider with >>clio syntax
• Status bar integration

Usage

Terminal Link

Simply type >>clio followed by your query in any terminal:

>>clio list all files in current directory

Clio will highlight this text, and when clicked, it will generate the appropriate command with an option to execute.

Command Palette

1. Press Ctrl+Shift+P (or Cmd+Shift+P on macOS) to open the command palette
2. Type "Clio: Run CLI Command"
3. Enter your query when prompted

Status Bar

Click on the "Clio" item in the status bar to quickly access Clio from any file.

Keyboard Shortcut

Press Ctrl+Shift+C (or Cmd+Shift+C on macOS) to directly access Clio.

Examples

• "Create a new directory called 'project' and initialize a git repo inside it"
• "List all Docker containers"
• "Find all JavaScript files in the current directory"
• "Create a new React app"
• "Show CPU and memory usage"

Requirements

• VS Code 1.74.0 or higher
• Python 3.6 or higher (installed and accessible in your PATH)
• Internet connection for API access

Extension Settings

This extension contributes the following settings:

• clio.apiKey: Set a custom OpenRouter API key
• clio.autoInitialize: Enable/disable automatic terminal initialization

Known Issues

• The extension requires Python to be installed and accessible from PATH
• External terminals may require manual initialization using the "Clio: Setup Terminal Integration" command

Release Notes

0.1.0

Initial release of Clio with core functionality:

• Command generation and execution
• Terminal integration
• Command palette and keyboard shortcuts
• Status bar integration

Acknowledgments

Clio uses the OpenRouter API to access AI models for command generation.