Your magical command-line assistant that combines developer utilities with AI superpowers!
- 📁 File Operations - List, search, and manage files
- 🌳 Directory Tree - Visualize project structure
- 🕐 System Info - Time, user, and system information
- 🧹 Cleanup Tools - Remove clutter files automatically
- 🚀 Project Init - Bootstrap new projects
- 💬 Interactive Chat - Terminal-based AI conversations
- ✍️ Text Summarization - Summarize any text or file
- 🌍 Translation - Translate text to any language
- 💻 Code Generation - Generate code from descriptions
- 🐛 Code Debugging - Find and fix bugs automatically
- 📝 Git Commit Messages - Generate perfect commit messages
- 📚 Documentation - Auto-generate code documentation
- 💡 Idea Generation - Creative ideas for any project
- 🎨 Creative Writing - Poems, emails, and more
# Install globally
npm install -g genie-assist
# Or use without installing
npx genie-assistOn first run, Genie will ask for your Google Gemini API key:
- Get your free API key at Google AI Studio
- Run
genieand paste your API key when prompted - Start using AI features immediately!
genieLaunch the interactive menu to explore all features.
genie --ls # List files
genie --tree # Show directory tree
genie --time # Current time
genie --whoami # System info
genie --find "*.js" # Find files
genie --clean # Remove clutter
genie --init # Create READMEgenie --chat # Start AI chat
genie --summarize "Your text here" # Summarize text
genie --explain "quantum computing" # Explain concepts
genie --translate "Hello" --lang es # Translate text
genie --codegen "React login form" # Generate code
genie --debug "your code here" # Debug code
genie --commitmsg # Generate commit message
genie --docs "function code" # Generate docs
genie --summarize-file README.md # Summarize file
genie --idea --type startup # Generate ideas
genie --poem "ocean sunset" # Write poetry
genie --email "meeting request" # Generate emailsgenie --codegen "Express.js API with authentication"genie --debug "
function factorial(n) {
if (n = 1) return 1;
return n * factorial(n - 1);
}
"git add .
genie --commitmsg
# Output: "feat: add user authentication with JWT tokens"genie --summarize-file package.json
# Get AI insights about your project dependenciesGenie stores its configuration in:
- macOS/Linux:
~/.config/genie-assist/config.json - Windows:
%APPDATA%/genie-assist/config.json
rm ~/.config/genie-assist/config.json # Unix
# Or delete the config file on WindowsGenie uses Google Gemini 1.5 Flash for all AI features:
- ⚡ Ultra-fast responses
- 🆓 Free tier available
- 🧠 Advanced reasoning capabilities
- 🌐 Multilingual support
We welcome contributions! Here's how to get started:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'feat: add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request
git clone https://github.com/your-username/genie-assist.git
cd genie-assist
npm install
npm run devMIT License - see the LICENSE file for details.
- Google Gemini for powering our AI features
- Chalk for beautiful terminal colors
- Inquirer for interactive prompts
- Figlet for ASCII art magic
Made to ease out daily tasks - It is an open sourced project and your contributions are highly appreciated
Star ⭐ this repo if you find it helpful!