grucli 3.3.1

A command-line interface for interacting with local and remote LLMs.

gru-cli -- Version 3.3.1

grucli is a CLI tool for agentic LLMs that works with both local LLMs and API-based models such as Claude, Gemini, GPT-5 and others.

why?

I hate how other CLI tools are overcomplicated, heavy, are exclusive to one API, and sometimes don't even let you change models.

So I decided to make my own CLI tool :)

It has support for multiple APIs, both remote and local ones.

I'll keep improving this project as time goes on.

Features

• Interactive Chat: Have a conversation with your chosen LLM right from your terminal.
• Model Selection: Easily switch between different models within the chat session.
• Command System: Use slash commands (/help, /model, /clear, /manage-api-keys) for quick actions.
• Context-Aware: Automatically injects your project's file tree into the system prompt to give the LLM better context.
• Encrypted API keys You don't need to worry about someone snooping your API keys, they're encrypted :)

Supported APIs

GruCLI supports models from the following providers:

• OpenAI: All available models, including GPT-5.2

• Anthropic: All available models, including Claude Opus and Sonnet 4.5.

• Gemini: Supports both Gemini API and Google AUTH

• Ollama: Supports both local and cloud models.

• LM Studio: Supports all local models.

• Cerebras: Supports their API available models.

• If a model doesn't show up on your selected API, you can just type it out.

Installation:

• For regular use:
  This installs the CLI like any other tool.

  pip install grucli
  

• For development:
  First, clone the repository and then install in editable mode:

  git clone https://github.com/grufr/grucli.git
  cd grucli
  pip install -e .
  

This will install the grucli command and all its dependencies.

WARNING !!

This project was NOT tested on Windows, it was only tested on Linux and macOS!!

Though it should mostly work, if you have issues, blame them on windows.

Usage

Once installed, you can start the CLI by simply running:

grucli

This will ask you to select an available model and then take you to the chatting interface.

Commands

• /help: Show available commands.
• /model: Re-open the model selection menu.
• /clear: Clear the current chat history.
• /manage-api-keys: Manage your saved API keys.
• /gemini-login: Login with your Google account.
• /gemini-auth-mode: Switch Gemini authentication between API Key and Google Auth.
• /exit: Exit the application.

Development

If you want to contribute to or modify grucli, you should install it in "editable" mode as described above (pip install -e .).

This allows you to edit the Python files in the src/grucli/ directory and have your changes be live the next time you run the grucli command. There is no need to run pip install . again after every code change.

If you change dependencies in requirements.txt or settings in setup.py, you should run pip install -e . again to apply those changes.

Testing

grucli uses pytest for testing. To run the tests, you must install pytest manually as it is not included in requirements.txt.

pip install pytest
pytest tests/

If you want to contribute your code must pass all tests.

Uninstallation

To remove grucli from your system, simply run:

pip uninstall grucli

License

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

silly

Some of the code here was generated by grucli itself :)

My first public open source project 💖🎀