cmd-ai

cmd‑ai is a command‑line assistant that translates natural‑language prompts into real shell commands. It works with a variety of AI providers—local Ollama models by default, or OpenAI, Google Gemini, and Anthropic Claude APIs—allowing users to request tasks such as checking disk space, listing Docker containers, or removing files. The tool presents the generated command, optionally explains it, and executes it after confirmation, with a dry‑run mode for safety.

The utility builds a local inventory of available executables from the user’s PATH and detects common package managers, feeding this context to the model so it can prefer installed tools or suggest installations when needed. Configuration, including provider selection, model choice, API keys, and reasoning effort, is stored in a user‑specific JSON file. Built‑in history and autocompletion features integrate with Bash or Zsh, enhancing workflow efficiency.

Developers can install cmd‑ai globally via npm, link a local repository for rapid iteration, and run automated checks during development. The project follows a plain Node.js ESM architecture without a transpilation step, making it straightforward to test and extend.