kolosal-cli

# Kolosal CLI

<div align="center">

[![npm version](https://img.shields.io/npm/v/@kolosal-ai/kolosal-ai.svg)](https://www.npmjs.com/package/@kolosal-ai/kolosal-ai)
[![License](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](./LICENSE)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org/)

**AI-powered command-line workflow tool for developers**

[Installation](#installation) • [Quick Start](#quick-start) • [Features](#features) • [Documentation](./docs/) • [Contributing](./CONTRIBUTING.md)

</div>

Kolosal CLI is a powerful command-line AI workflow tool that enhances your development workflow with advanced code understanding, automated tasks, and intelligent assistance. Based on Qwen Code models, it provides seamless integration with your existing development environment.

## Features

- **Code Understanding & Editing** - Query and edit large codebases beyond traditional context window limits
- **Workflow Automation** - Automate operational tasks like handling pull requests and complex rebases
- **Enhanced Parser** - Optimized specifically for code-oriented models
- **Vision Model Support** - Automatic detection and multimodal analysis of images in your input
- **Flexible Model Support** - Works with OpenAI-compatible APIs and Hugging Face models

## Installation

### Quick Install (Recommended)

Install KolosalCode with a single command:

```bash
# macOS or Linux
curl -fsSL https://raw.githubusercontent.com/KolosalAI/kolosal-cli/main/install.sh | bash

# Linux (with sudo)
curl -fsSL https://raw.githubusercontent.com/KolosalAI/kolosal-cli/main/install.sh | sudo bash
```

The installer automatically detects your operating system and installs the appropriate package.

### Alternative Installation Methods

<details>
<summary>Install from npm</summary>

Requires [Node.js version 20](https://nodejs.org/en/download) or higher.

```bash
npm install -g @kolosal-ai/kolosal-ai@latest
kolosal --version
```
</detai