Cloi: Your Terminal-Based AI Debugging Assistant for Smarter Local Development

🔍 What is Cloi?

Cloi is a context-aware debugging assistant that runs entirely on your local machine. It ensures your code and data never leave your device. Once authorized, Cloi analyzes errors and can even propose and apply code fixes directly to your project. Currently in its experimental phase, Cloi may still have some quirks—users are advised to carefully review any AI-generated changes before applying them.

⚙️ Key Features

• Local Execution, Full Privacy: Cloi runs 100% locally and doesn’t require any API keys, ensuring full data privacy and security.

• Auto Debugging with LLMs: It uses large language models to detect and suggest fixes for errors found in your code.

• Interactive Command Support:

  • /debug – Auto-analyze and propose fixes

  • /model – Switch models via Ollama

  • /history – Review recent shell commands

  • /help – Display command help

  • /exit – Exit the assistant

• Customizable Model Options: Default model is Phi-4, but users can switch to other supported models via Ollama.

• Free and Open-Source: Cloi is completely open-source, allowing anyone to extend or customize it for their needs.

🧠 Technical Architecture

Cloi is built using the following technologies:

• Node.js: Provides a robust runtime and extensive ecosystem.

• Large Language Models (LLMs): Power the error analysis and code-fix generation logic.

• Server-Sent Events (SSE): Enables real-time communication between Cloi and your terminal.

This technical stack ensures Cloi is fast, efficient, and responsive in real-world development environments.

📦 Project Repository

• GitHub: https://github.com/cloi-ai/cloi

💼 Use Cases

• Everyday Debugging for Developers: Quickly identify and resolve issues during development.

• Education & Training: Help beginners understand errors and learn debugging techniques.

• Code Review Assistance: Automate error detection and suggestion during peer reviews.

• Agile Development Support: Provide real-time debugging aid during fast-paced development cycles.