cmdgenie

cmdgenie

cmdgenie is an AI-powered assistant that generates shell commands from the comfort of your command line.

Features

• OS-aware: cmdgenie returns operating system-appropriate commands.
• Verbosity controls: return the command only, or include descriptions and examples.
• Configurable model: choose from any of the supported OpenAI models.
• No Dependencies: a standalone binary with no external dependencies. Just download and run!

Installation

Linux / MacOS

curl -fsSL https://raw.githubusercontent.com/j-dumbell/cmdgenie/main/install.sh | sh

Windows

Download the exectuable for your architecture directly from GitHub Releases.

Via Go

1. Install Go version >=1.24.0
2. Install via go install:

   go install github.com/j-dumbell/cmdgenie@latest
   

From source

1. Install Go version >=1.24.0
2. Clone the repository.
3. Build the binary.

   go build -o cmdgenie .
   

4. Move to directory in your path (optional):

   mv cmdgenie /usr/local/bin/
   

Usage

ℹ️ Info:
For full documentation, refer to the CLI help docs: cmdgenie --help

Configuration

To set your OpenAI API key and choose a default model, run:

cmdgenie configure

Generating a command:

cmdgenie ask "list all hidden files"

List all models:

cmdgenie list-models

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Feel free to submit a pull request or open an issue.

Author

James Dumbell