CodeMaxx

CodeMaxx is a cross-platform CLI tool that helps developers understand, and fix code using multiple large language models (LLMs).

---

Installation

Choose your OS:

Windows (PowerShell)

iwr https://raw.githubusercontent.com/Saisathvik94/codemaxx/main/scripts/install.ps1 -UseBasicParsing | iex

Run as Administrator

Linux/macOS

curl -sSL https://raw.githubusercontent.com/Saisathvik94/codemaxx/main/scripts/install.sh | sudo bash

After installation, codemaxx will be available on your PATH.

---

Using Local AI (Ollama)

1. Install Ollama

https://ollama.com

2. Pull the model:

ollama pull qwen2.5-coder:3b

3. Select it inside CodeMaxx:

codemaxx models

Now all commands will run locally without sending your code to external APIs.

Best for:

• Private repositories

• Offline development

• Security-sensitive projects

Setup API Keys (Cloud Models)

For cloud providers:

codemaxx keys

Workflow:

1. Select a provider (OpenAI, Anthropic, Gemini, Perplexity, etc.)

2. Enter your API key

3. Save configuration

You can switch models anytime using:

codemaxx models

Available Commands

1. explain

Explain what your code does.

codemaxx explain <path>
codemaxx explain <path> --prompt "Explain this in simple terms"
codemaxx explain --prompt "For what Golang is famous for?"

2. fix

Fix errors and refactor code.

codemaxx fix <path>
codemaxx fix <path> --prompt "Refactor using best practices"

3. review

AI-powered Git review.

codemaxx review
codemaxx review --prompt "Focus on performance issues"

What it does:

• Reads staged Git changes

• Analyzes diff intelligently

• Detects bugs & vulnerabilities

• Suggests improvements

Perfect before every commit.

4. keys

Manage API keys.

codemaxx keys

5. models

Switch between cloud and local models.

codemaxx models

6. upgrade

Upgrade CodeMaxx to the latest available version.

codemaxx upgrade

What it does:

• Checks the latest GitHub release

• Compares with your current version

• Downloads the latest binary

• Replaces the existing installation

• Preserves your configuration

No manual reinstall required.

How CodeMaxx Works

1. Select a model (Cloud or Local)
2. Provide code / file / Git diff
3. CodeMaxx structures intelligent prompts
4. The model analyzes your code
5. Clean, formatted output appears in your terminal

Zero UI clutter. Maximum developer speed.

Security First

• You control where your code goes.

• Use cloud LLMs for best intelligence

• Use local Ollama for privacy

• Always review AI suggestions

• Use version control before applying fixes

Contributing

• Pull requests are welcome!

• Fork the repo

• Create a feature branch

• Commit your changes

• Open a PR

MIT License

Free to use, modify, and distribute.