Linux commands— explained, generated, taught.
NPM Package
My Role
Full-Stack Developer
CLI Tool Designer
Open Source Maintainer
Tools
Visual Studio Code
NPM
Git & GitHub
Vercel
Postman
Tech Stack
Node.js
TypeScript
Commander.js
Inquirer.js
Axios
Chalk
Multiple LLM APIs
Ollama
Vercel
Timeline
2025
Description
A privacy-focused CLI tool that transforms natural language into terminal commands using AI, with flexible API key management and complete transparency.
Context
Born from my frustration of constantly googling Linux commands while learning, cmdo eliminates the browser-switching workflow. Users can either use my managed server with built-in rate limits or configure their own API keys through an interactive setup menu. The tool makes direct API calls from their terminal using their credentials, ensuring complete privacy and security - no data passes through my servers when using personal keys.
Problem Statement
Developers constantly interrupt their workflow to search for command syntax online, while existing AI tools require sharing sensitive data with third-party services or lack flexibility in AI provider choice.
Solution
Built a transparent CLI tool where users choose between my managed service or their own API keys. When using personal keys, all AI requests go directly from their terminal to their chosen provider - bypassing my servers entirely for complete privacy.
Key Features
- Generate commands from natural language ("find large files")
- Explain any command with detailed breakdowns
- Interactive learning mode with step-by-step teaching
- Show practical usage examples for commands
- Improve and optimize existing commands
- Convert commands between different platforms
- Debug error messages with AI assistance
- Privacy-first: use your own API keys or my managed service
Privacy & Transparency
Users can configure their own API keys through an interactive CLI menu. When using personal keys, the tool makes direct API calls to chosen providers without any backend requests to my servers. Full source code available on GitHub for complete transparency and community contributions.
Challenges & Learnings
Designing a flexible architecture that supports both managed and self-hosted API usage while maintaining security. Learned the importance of giving users control over their data and API costs.
Outcome
Published to NPM for easy installation, deployed web presence to Vercel, and open-sourced on GitHub. Users can choose between convenience (managed service) or complete control (own API keys) based on their needs.