The Problem Every Admins/Developer Faces
How many times have you found yourself staring at your terminal, trying to remember that exact Docker command? Or wondering how to check your firewall status? Or struggling to recall the right systemctl command for troubleshooting?
Or maybe you need to quickly prototype something—a Python script, a bash automation, or a configuration file. You know what you want to build, but you don’t want to spend time searching through documentation, Stack Overflow, or piecing together examples from different sources.
We’ve all been there. You know the solution exists, you’ve done it before, but your brain decides to take a coffee break right when you need it most. You end up opening browser tabs, searching through your notes, or asking colleagues—all while your workflow grinds to a halt.
What if you could just ask your terminal directly?
Meet Nexus CLI Assistant
I’m excited to introduce Nexus CLI Assistant—a lightweight, open-source CLI tool that brings AI-powered answers directly to your terminal. Think of it as having a knowledgeable colleague sitting next to you, ready to help with Linux commands, Docker operations, code generation, system administration questions, and more—instantly.
Why I Built It
As someone who works extensively with Ubuntu, Docker, Ollama, and various system administration tasks, I found myself constantly forgetting commands or needing quick references. I wanted something that:
- Works entirely locally (privacy-first with Ollama support)
- Provides instant, contextual answers
- Remembers my favorite commands
- Doesn’t require leaving my terminal
- Is fast, lightweight, and easy to use
So I built it. And now I’m sharing it with the community.
Key Features That Make It Special
🤖 Multiple AI Providers
Nexus CLI Assistant supports multiple AI backends, giving you flexibility:
- Ollama (default) – Run completely locally, no API keys needed
- OpenAI – For when you need cloud-powered responses
- Anthropic (Claude) – Another excellent cloud option
- DeepSeek – Cost-effective alternative
Switch between providers with a single command:
nexus config --set-provider ollama
🎨 Beautiful Structured Output
One of my favorite features is how answers are presented. Instead of a wall of text, you get:
- 📋 Commands/Code Section: All detected commands and code snippets in syntax-highlighted code blocks
- 💡 Explanation Section: Full context and details in beautifully formatted markdown
This makes it incredibly easy to quickly grab the command or code you need while still having access to detailed explanations. Whether it’s a one-liner command or a complete Python script, everything is properly formatted and ready to use.
💾 Smart Command Management
Save your favorite commands in organized categories:
nexus save docker "docker ps -a"
nexus save ufw "sudo ufw status"
Then retrieve them instantly:
nexus quick docker # No AI needed, instant access
⚡ Performance Optimizations
- Caching: Common questions are cached for instant responses
- Rate Limiting: Built-in protection against API limits
- Command History: All your queries are saved for quick reference
Real-World Examples
Example 1: Command Lookup
Let me show you how I use it daily. Say I need to check for issues in my Docker containers:
$ nexus ask with what command i can check for issues in a docker
The response comes back beautifully formatted with all the Docker troubleshooting commands, syntax-highlighted and ready to use.
Example 2: Code Generation
But it’s not just about commands. Recently, I needed to implement Microsoft Single Sign-On in Python. Instead of spending time researching OAuth2 flows and Azure AD documentation, I simply asked:
$ nexus ask could you create a single sign-on for ms in python?
The tool generated:
- Complete Flask application with OAuth2 implementation
- Proper authentication flow handling
- Security best practices
- Multiple implementation approaches
- Ready-to-use code blocks
All properly formatted, syntax-highlighted, and ready to adapt. The structured output makes it easy to:
- Quickly identify the code sections you need
- Understand the implementation approach
- Copy-paste code blocks directly
- Learn from the explanations
This is the power of having an AI assistant that understands both system administration and software development.
Getting Started
Installation is straightforward:
# Clone the repository
git clone https://github.com/nexus-mike/Nexus-CLI-Assistant.git
cd nexus-cli-assistant
# Run the installation script
./scripts/install.sh
# Activate the virtual environment
source venv/bin/activate
# Start asking questions!
nexus ask "how to check UFW firewall status"
The installation script handles everything: creates a virtual environment, installs dependencies, sets up configuration, and you’re ready to go.
Privacy-First Design
One of the core principles behind Nexus CLI Assistant is privacy. By default, it uses Ollama—which runs entirely on your machine. No data leaves your system unless you explicitly choose to use a cloud provider.
This makes it perfect for:
- Working with sensitive information
- Offline environments
- Users concerned about data privacy
- Organizations with strict security policies
More Than Just Commands
While Nexus CLI Assistant excels at finding commands, it’s also incredibly powerful for code generation. Need a quick Python script? A bash automation script? A configuration file? Just ask.
Code Generation Example
Recently, I needed to create a Single Sign-On (SSO) implementation for Microsoft in Python. Instead of searching through documentation and examples, I simply asked:
nexus ask could you create a single signon for ms in python?
The response came back with:
- Complete Flask application code
- OAuth2 implementation
- Security considerations
- Multiple implementation approaches
- Ready-to-use code blocks
All syntax-highlighted, properly formatted, and ready to adapt to my needs. This isn’t just a command lookup—it’s a full code generation assistant that understands context and best practices.
Use Cases
I’ve found Nexus CLI Assistant incredibly useful for:
- Quick Command Lookups: “How do I check disk usage?” → Instant answer
- Code Generation: “Create a Python script to parse JSON” → Complete working code
- Docker Troubleshooting: “What’s the command to see container logs?” → Right there
- System Administration: “How to restart a service?” → No more searching
- Learning: The explanations help you understand why commands and code work
- Command Library: Save your frequently used commands for instant access
- Prototyping: Quickly generate boilerplate code for new projects
Open Source and Community-Driven
Nexus CLI Assistant is completely open source (MIT License) and available on GitHub. I’ve built it to be:
- Easy to contribute to: Well-documented code, clear structure
- Extensible: Easy to add new AI providers or features
- Community-focused: Issues, pull requests, and discussions welcome
Whether you want to add a new feature, fix a bug, or just use it and provide feedback, your involvement is welcome!
What’s Next?
The tool is actively being developed. Some features on the roadmap include:
- Context awareness (detecting your current directory/environment)
- Export/import of saved commands
- Enhanced search capabilities
- Multi-line command support
- And more based on community feedback
Try It Today
If you’re a developer, system administrator, or anyone who spends time in the terminal, I encourage you to give Nexus CLI Assistant a try. It’s free, open source, and might just become an essential part of your workflow.
Get started:
- GitHub: https://github.com/nexus-mike/Nexus-CLI-Assistant
- Documentation: See the README for full usage instructions
- Issues/Feedback: Open an issue on GitHub
Final Thoughts
Building Nexus CLI Assistant has been a journey of solving my own problems while creating something that others might find useful. The tool represents a simple idea: what if your terminal could answer questions as naturally as asking a colleague?
If you try it and find it useful, I’d love to hear about it. If you have ideas for improvements, contributions are always welcome. And if you just want to star the repository to show support, that’s appreciated too!
The terminal is a powerful tool. With Nexus CLI Assistant, it just got a little bit smarter.
About the Author
Maikel van den Brink is a developer passionate about creating tools that make developers’ lives easier. When not coding, you can find him tinkering with homelab setups, experimenting with AI models, or contributing to open-source projects.
Connect:
- GitHub: nexus-mike
- Project: Nexus CLI Assistant
Have you tried Nexus CLI Assistant? Share your experience in the comments below!