asktocmd 🤖

Did you forget your command-line commands? Don't worry! Now you can directly ask asktocmd, your AI-powered CLI helper. Ask about any command, operation, or CLI-related query, and get instant, intelligent responses powered by Google's Gemini AI.

🚀 Quick Start

1# Install globally
2npm install -g asktocmd
3
4# Set up your API key (get it from https://aistudio.google.com/app/apikey)
5asktocmd set-api-key YOUR_GEMINI_API_KEY
6
7# Start asking questions!
8asktocmd "How do I list all files in a directory?"

🌟 Features

• 🤖 AI-powered responses to command-line queries using Google's Gemini AI
• 💬 Interactive mode for continuous questioning
• 🎨 Beautiful terminal output with syntax highlighting
• 📝 Markdown formatting for easy readability
• 🚀 Fast and efficient responses
• 📚 Comprehensive command-line knowledge
• 🌐 Works across different operating systems

📦 Installation

To install asktocmd globally:

1npm install -g asktocmd

Verify the installation:

1asktocmd --version

🔑 API Key Setup

asktocmd requires a Gemini API key to function. Here's how to get started:

1. Get your API key:

   • Visit Google AI Studio to create your API key
   • If you're new, you'll need to sign in with your Google account
   • Click on "Create API key" and copy your new key

2. Set up the key using one of these methods:

   a. Using the CLI command (recommended):

   1asktocmd set-api-key YOUR_GEMINI_API_KEY

   b. Manual configuration:

   • The key is stored in ~/.asktocmd-config.json
   • You can edit this file directly if needed

🖥 Usage

asktocmd offers two modes of operation:

1. Direct Query Mode

Perfect for quick, one-off questions:

1# Basic usage
2asktocmd "How do I find the largest files in a directory?"
3
4# Complex queries
5asktocmd "How do I use grep to search for multiple patterns?"

2. Interactive Mode

Great for multiple questions or learning sessions:

1asktocmd -i

This starts an interactive session where you can:

• Ask multiple questions
• Get immediate responses
• Type 'exit' to quit

📋 Example Queries

1# File operations
2asktocmd "How do I recursively search for files?"
3
4# Process management
5asktocmd "How do I kill a process using a specific port?"
6
7# System information
8asktocmd "How can I check system resource usage?"

🛠 Advanced Usage

1# Get help
2asktocmd --help
3
4# Check version
5asktocmd --version
6
7# Update API key
8asktocmd set-api-key NEW_API_KEY

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create your feature branch: git checkout -b feature/new-feature
3. Commit your changes: git commit -am 'Add new feature'
4. Push to the branch: git push origin feature/new-feature
5. Submit a pull request

🐛 Bug Reports

Found a bug? Please report it on our issues page with:

• A clear description of the issue
• Steps to reproduce
• Expected vs actual behavior

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Pranav

• Twitter: @21prnv
• GitHub: @21prnv

💖 Support

If you find asktocmd helpful:

• ⭐ Give it a star on GitHub
• 📢 Share it with your fellow developers
• 🐦 Follow the creator on Twitter for updates

🙏 Acknowledgments

• Google Gemini AI for powering the responses
• The open-source community for inspiration and support

Happy command-line querying! 🎉