Kaze CLI

AI-powered coding assistant with Claude Code-like experience

Features • Installation • Quick Start

Features

• Multi-Provider AI Support - Zai, OpenAI, Anthropic, Groq, Mistral, Cohere, and more
• Interactive REPL - Natural conversation interface in your terminal
• File System Operations - Read, write, search, and manage files
• Semantic Codebase Search - Find code across your entire project
• Terminal Integration - Execute commands directly and see results
• Task Management - Built-in todo list for tracking work
• Personality System - Customize AI behavior for different use cases
• MCP Support - Extend functionality with Model Context Protocol servers
• Streaming Responses - Real-time AI responses as they're generated

Installation

npm install -g kaze-cli

Requirements: Node.js >= 16.0.0

Quick Start

kaze

On first run, configure:

• Select AI provider
• Enter API key
• Choose default model
• Configure interface preferences

> Help me create a REST API in Node.js

I'll help you create a REST API in Node.js using Express...

[index.js](file:///path/to/index.js#L1-L30)
```javascript
const express = require('express');
const app = express();

app.use(express.json());

let users = [{ id: 1, name: 'John Doe', email: '[email protected]' }];

app.get('/api/users', (req, res) => res.json(users));
app.get('/api/users/:id', (req, res) => {
  const user = users.find(u => u.id === parseInt(req.params.id));
  if (!user) return res.status(404).json({ error: 'User not found' });
  res.json(user);
});
app.post('/api/users', (req, res) => {
  const user = { id: users.length + 1, ...req.body };
  users.push(user);
  res.status(201).json(user);
});

app.listen(3000, () => console.log('Server running on port 3000'));

## Configuration

### Environment Variables

Create a `.env` file:

```bash
ZAI_API_KEY=your_api_key_here
ZAI_API_URL=https://api.z.ai/v1
ZAI_MODEL=GLM-4.7

OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key

Configuration File

Stored at ~/.kaze/config.json:

{
  "api": {
    "provider": "zai",
    "apiKey": "your_api_key",
    "baseUrl": "https://api.z.ai/v1",
    "model": "GLM-4.7",
    "maxTokens": 8192,
    "temperature": 1.0
  },
  "interface": {
    "theme": "default",
    "showThinking": true,
    "streaming": true
  },
  "tools": {
    "filesystem": true,
    "terminal": true,
    "codebase": true,
    "todo": true
  }
}

Interactive Setup

kaze config init

Commands

System Commands

| Command | Description | |---------|-------------| | /help | Show all available commands | | /clear | Clear conversation history | | /config | Open configuration menu | | /exit or /quit | Exit the CLI |

Personality Commands

| Command | Description | |---------|-------------| | /personality list | List all available personalities | | /personality use <name> | Activate a personality | | /personality add | Create a new personality | | /personality remove <name> | Delete a personality | | /personality clear | Revert to default behavior |

Tool Commands

| Command | Description | |---------|-------------| | /file <path> | Read a file | | /write <path> | Write content to a file | | /search <query> | Search the codebase | | /run <command> | Execute a terminal command | | /todo | Manage tasks |

MCP Commands

| Command | Description | |---------|-------------| | /mcp list | List configured MCP servers | | /mcp connect <name> | Connect to an MCP server | | /mcp disconnect <name> | Disconnect from a server | | /mcp tools [name] | List available tools |

Supported AI Providers

| Provider | Models | Best For | |----------|--------|----------| | Zai | GLM-4.7, GLM-5 | General coding, reasoning | | OpenAI | GPT-4 Turbo, GPT-4, GPT-3.5 | Well-known, reliable | | Anthropic | Claude 3 Opus, Sonnet, Haiku | Complex reasoning | | Groq | Mixtral, Llama 2 | Fast, cost-effective | | Mistral | Mistral Large, Medium, Codestral | European data | | Cohere | Command, Command Light | Text generation |

Built-in Personalities

Coding Expert

Expert software engineer for technical tasks.

/personality use coding-expert

Concise

Direct, minimal responses.

/personality use concise

Creative

Exploratory and inventive.

/personality use creative

Development

git clone https://github.com/017016/kaze-cli.git
cd kaze-cli
npm install
npm run build
npm run dev

Documentation

• Complete Documentation - Comprehensive feature guide
• MCP Guide - Model Context Protocol integration
• Personality System - Creating and using personalities

License

MIT License - see LICENSE file for details

Support

GitHub • npm Discord