A context-aware terminal assistant that leverages Google's Gemini AI to help with command line tasks, scripting, and system administration.
- 🗃️ Persistent command history with timestamp tracking
- 📖 Automatic markdown rendering with glow
- 💻 OS/shell context-aware responses
- 🗑️ Safe history deletion (single items or all)
curl -sSL https://raw.githubusercontent.com/rafaelfagundes/ask/main/install.sh | bash- Install required dependencies:
go install github.com/charmbracelet/glow@latest- Build and install:
go install github.com/rafaelfagundes/ask/cmd/ask@latestask "How do I recursively find and delete .tmp files?"ask
> Enter your question: How to monitor CPU usage?ask history # List all queries
ask history delete 3 # Delete item 3
ask history delete all # Clear all history
ask last # Show last response- Get Gemini API Key from Google AI Studio
- Add to your shell profile:
export GEMINI_API_KEY="your-api-key-here"Configuration files stored in:
${XDG_CONFIG_HOME:-$HOME/.config}/ask
System Administration
ask "Quick checklist for securing a new Ubuntu server"
Scripting Help
ask "Create a bash script to backup directory with timestamp"
Troubleshooting
ask "Debug 'Permission Denied' error after chmod"
DevOps
ask "Explain Kubernetes pod lifecycle in simple terms"
We welcome contributions! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Google Gemini API for AI capabilities
- Charmbracelet Glow for markdown rendering
- SQLite for lightweight history storage