Commandor is an intelligent terminal assistant that uses AI to convert natural language into shell commands and now answers questions directly with /ask.
It brings the power of generative AI to your terminal to improve productivity, reduce mental load, and streamline development workflows.
Docker Image:
Available at https://hub.docker.com/r/ravind2704/commandor
Support open source software by participating in Hacktoberfest and get goodies and digital badges! 💙
/ai– Convert natural language instructions into shell commands/ask– Ask AI questions about programming, systems, tools, and general knowledge- Color-coded terminal interface with clear separation of user and AI input
- Context-aware suggestions based on current working directory
- Safety checks before executing potentially destructive commands
- Command history navigation with arrow keys
- Cross-platform support: Linux, macOS, and Windows
git clone https://github.com/ravin-d-27/Commandor.git
cd Commandor
pip install -e .Obtain your Gemini API key from Google AI Studio
Commandor is also available as a Docker image:
docker pull ravind2704/commandordocker run -it ravind2704/commandorRun Commandor from your terminal:
commandor| Command | Description |
|---|---|
/ai <instruction> |
Converts a natural language instruction into a shell command |
/ask <question> |
Asks AI a general or technical question |
/help |
Shows usage information and supported commands |
/info |
Displays basic system information |
/history |
Shows the history of AI-generated commands |
/clear |
Clears the terminal screen |
exit or Ctrl+C |
Exits Commandor |
/ai list all .py files
# Output: find . -name "*.py" -type f
/ask What is a virtual environment in Python?
# Output: Detailed explanation generated by AICommand not found
- Confirm installation with
pip show commandor - Check your
$PATHor activate your virtual environment
API Key errors
- Ensure your
.envcontains a valid key:GEMINI=your_key_here - Verify your key at Google AI Studio
- You can also test the API by /test-api command in commandor
Windows users
pip install pyreadline3We welcome contributions from developers, testers, and writers.
- Star the repository
- Report bugs and request features via GitHub Issues
- Submit pull requests with meaningful improvements
- Follow code conventions and include test cases for new features
Commandor is open-source and free to use with attribution.
- You must include the line: "Powered by Commandor" in commercial tools
- You must provide a visible link back to the GitHub repository
See LICENSE for full terms.
Created by Ravin D
- GitHub: https://github.com/ravin-d-27
- Email: [email protected]
If you find Commandor useful:
- Star the GitHub repository
- Share it with others in your developer community
pip uninstall commandorVersion: 0.0.1 Status: Actively maintained