zarz 0.3.1-alpha

package/Cargo.toml

@@ -0,0 +1,30 @@
+[package]
+name = "zarzcli"
+version = "0.3.1-ALPHA"
+edition = "2024"
+
+[dependencies]
+anyhow = "1.0.100"
+clap = { version = "4.5.51", features = ["derive"] }
+dialoguer = "0.12"
+reqwest = { version = "0.12.24", features = ["json", "gzip", "brotli", "stream", "rustls-tls"] }
+serde = { version = "1.0.228", features = ["derive"] }
+serde_json = "1.0.145"
+similar = "2.7.0"
+tokio = { version = "1.48.0", features = ["macros", "rt-multi-thread", "fs", "io-util", "process"] }
+async-trait = "0.1.89"
+rustyline = { version = "17.0.2", features = ["custom-bindings"] }
+crossterm = "0.29.0"
+futures = "0.3.31"
+tokio-stream = "0.1.17"
+eventsource-stream = "0.2.3"
+ignore = "0.4.25"
+walkdir = "2.5.0"
+tree-sitter = "0.25.10"
+syn = { version = "2.0.108", features = ["full", "parsing", "visit"] }
+regex = "1.12.2"
+bytes = "1.10.1"
+toml = "0.9.8"
+quote = "1.0.41"
+dirs = "6.0.0"
+chrono = { version = "0.4.39", features = ["serde"] }

package/QUICKSTART.md

@@ -0,0 +1,326 @@
+# ZarzCLI Quick Start Guide
+
+ZarzCLI is an AI-powered coding assistant that works directly from your command line, similar to Claude Code and Codex CLI.
+
+## Installation
+
+1. Make sure you have Rust installed:
+```bash
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+```
+
+2. Build ZarzCLI:
+```bash
+cd ZarzCLI
+cargo build --release
+```
+
+3. Set up your API key:
+```bash
+# For Claude (Anthropic)
+export ANTHROPIC_API_KEY=sk-ant-your-key-here
+
+# Or for OpenAI
+export OPENAI_API_KEY=sk-your-key-here
+```
+
+## Basic Usage
+
+### 1. Interactive Chat (Default)
+
+Just run `zarz` to start an interactive session:
+
+```bash
+./zarz.bat  # Windows
+./zarz.sh   # Linux/Mac
+```
+
+You'll enter a chat session where you can ask questions and edit code:
+
+```
+Zarz Interactive Session
+Type /help for available commands, /quit to exit
+
+> What does this codebase do?
+Assistant: [AI analyzes your project...]
+
+> /edit src/main.rs
+Loaded src/main.rs for editing
+
+> Add better error handling
+Assistant: [AI suggests changes with file blocks]
+File changes detected. Use /diff to review, /apply to apply
+
+> /diff
+[shows unified diff]
+
+> /apply
+Applied changes to src/main.rs
+
+> /quit
+Goodbye!
+```
+
+### 2. One-Shot Questions
+
+Send a single question and get an answer:
+
+```bash
+zarz --message "Explain what this function does" -f src/auth.rs
+```
+
+Or shorter with alias:
+
+```bash
+zarz --msg "Fix the bug in this file" -f src/main.rs
+```
+
+### 3. Switch Models On-the-Fly
+
+Start with one model, switch to another mid-conversation:
+
+```bash
+zarz
+
+> /model claude-haiku-4-5
+Switched to model: claude-haiku-4-5
+Provider: anthropic
+
+> Add docstrings
+[Uses faster, cheaper Haiku model]
+
+> /model gpt-5-codex
+Switched to model: gpt-5-codex
+Provider: openai
+
+> Optimize this algorithm
+[Uses GPT-5 Codex]
+```
+
+## Available Models
+
+### Anthropic Claude
+
+- **claude-sonnet-4-5-20250929** (default) - Best for complex coding ($3/$15 per 1M tokens)
+- **claude-haiku-4-5** - Fast and cheap ($1/$5 per 1M tokens)
+- **claude-opus-4-1** - Most powerful for complex tasks
+
+### OpenAI
+
+- **gpt-5-codex** - Optimized for coding ($1.25/$10 per 1M tokens)
+- **gpt-4o** - Multimodal
+- **gpt-4-turbo** - Fast
+
+## In-Chat Commands
+
+- `/help` - Show all commands and current model
+- `/model <name>` - Switch AI model
+- `/edit <file>` - Load a file for editing
+- `/diff` - Preview pending changes
+- `/apply` - Apply pending changes
+- `/undo` - Discard pending changes
+- `/run <command>` - Execute shell command
+- `/search <symbol>` - Find symbol in codebase
+- `/context <query>` - Find relevant files
+- `/files` - List loaded files
+- `/clear` - Clear conversation history
+- `/quit` - Exit
+
+## Common Workflows
+
+### Workflow 1: Code Review and Fix
+
+```bash
+zarz
+
+> /edit src/server.rs
+> Review this code for security issues
+[AI finds issues]
+
+> Fix the SQL injection vulnerability
+[AI provides fix with file blocks]
+
+> /diff
+[Review changes]
+
+> /apply
+[Changes applied]
+
+> /run cargo test
+[Verify tests pass]
+```
+
+### Workflow 2: Add Feature with Cost Optimization
+
+```bash
+zarz
+
+# Use Sonnet for planning
+> Design an authentication system with JWT
+
+# Switch to Haiku for implementation (cheaper)
+> /model claude-haiku-4-5
+> Implement the JWT authentication based on your design
+
+# Back to Sonnet for complex parts
+> /model claude-sonnet-4-5-20250929
+> Add rate limiting and refresh token logic
+```
+
+### Workflow 3: Multi-File Refactoring
+
+```bash
+zarz
+
+> /edit src/main.rs
+> /edit src/config.rs
+> /edit src/handlers.rs
+
+> Refactor these files to use async/await consistently
+
+> /diff
+[Shows changes across all files]
+
+> /apply
+[Applies all changes]
+
+> /run cargo check
+[Verify code compiles]
+```
+
+## Legacy Commands (Still Supported)
+
+### Ask Mode
+
+```bash
+zarz ask --prompt "What does this do?" src/main.rs
+```
+
+### Rewrite Mode
+
+```bash
+zarz rewrite --instructions "Add error handling" src/lib.rs
+```
+
+### Explicit Chat Mode
+
+```bash
+zarz chat
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# Model selection
+export ZARZ_MODEL=claude-sonnet-4-5-20250929
+
+# Provider selection
+export ZARZ_PROVIDER=anthropic  # or openai
+
+# Anthropic settings
+export ANTHROPIC_API_KEY=sk-ant-...
+export ANTHROPIC_API_URL=https://api.anthropic.com/v1/messages
+export ANTHROPIC_TIMEOUT_SECS=120
+
+# OpenAI settings
+export OPENAI_API_KEY=sk-...
+export OPENAI_API_URL=https://api.openai.com/v1/chat/completions
+export OPENAI_TIMEOUT_SECS=120
+
+# Advanced settings
+export ZARZ_MAX_OUTPUT_TOKENS=4096
+export ZARZ_TEMPERATURE=0.3
+```
+
+### Per-Command Overrides
+
+```bash
+# Use specific model
+zarz --model claude-haiku-4-5
+
+# Use OpenAI instead of default
+zarz --provider openai --model gpt-5-codex
+
+# Custom endpoint
+zarz --endpoint https://custom-api.example.com
+```
+
+## Tips for Best Results
+
+1. **Be Specific**: "Add error handling to the login function" is better than "improve the code"
+
+2. **Use Context**: Load relevant files with `/edit` before asking questions
+
+3. **Iterate**: Don't try to do everything at once. Make small, focused changes
+
+4. **Review Before Applying**: Always `/diff` before `/apply`
+
+5. **Choose the Right Model**:
+   - Sonnet 4.5: Complex refactoring, architecture decisions
+   - Haiku 4.5: Quick fixes, adding docstrings, simple tasks
+   - GPT-5 Codex: Agentic workflows, algorithm optimization
+
+6. **Cost Optimization**: Start with Sonnet for planning, switch to Haiku for implementation
+
+## Troubleshooting
+
+### API Key Not Found
+
+```bash
+Error: Environment variable ANTHROPIC_API_KEY is required
+
+# Fix:
+export ANTHROPIC_API_KEY=sk-ant-your-key
+```
+
+### Model Not Found
+
+```bash
+Error: Unknown model provider for 'typo-model'
+
+# Fix: Use /model without arguments to see available models
+> /model
+```
+
+### Build Errors
+
+```bash
+# Clean and rebuild
+cargo clean
+cargo build --release
+```
+
+## Next Steps
+
+- Read [MODELS.md](MODELS.md) for detailed model information
+- Check [README.md](README.md) for full documentation
+- Report issues: https://github.com/fapzarz/zarzcli/issues
+
+## Quick Reference Card
+
+```
+┌─────────────────────────────────────────────────┐
+│ ZarzCLI Quick Reference                         │
+├─────────────────────────────────────────────────┤
+│ Start Chat:       zarz                          │
+│ One-Shot:         zarz --message "prompt"       │
+│ With Files:       zarz -f file.rs               │
+│                                                 │
+│ In Chat:                                        │
+│   /help          Show all commands              │
+│   /model <name>  Switch AI model                │
+│   /edit <file>   Load file                      │
+│   /diff          Preview changes                │
+│   /apply         Apply changes                  │
+│   /undo          Discard changes                │
+│   /run <cmd>     Execute command                │
+│   /quit          Exit                           │
+│                                                 │
+│ Models:                                         │
+│   claude-sonnet-4-5-20250929 (default)         │
+│   claude-haiku-4-5 (fast/cheap)                 │
+│   gpt-5-codex (OpenAI)                          │
+└─────────────────────────────────────────────────┘
+```

package/README.md

@@ -0,0 +1,72 @@
+# ZarzCLI
+
+[![npm version](https://img.shields.io/npm/v/zarz.svg)](https://www.npmjs.com/package/zarz)
+[![npm downloads](https://img.shields.io/npm/dd/zarz.svg)](https://www.npmjs.com/package/zarz)
+[![GitHub release](https://img.shields.io/github/v/release/zarzet/ZarzCLI.svg)](https://github.com/zarzet/ZarzCLI/releases)
+[![License](https://img.shields.io/badge/license-Proprietary-red.svg)](LICENSE)
+
+Fast AI coding assistant for terminal built with Rust.
+
+## Installation
+
+```bash
+npm install -g zarz
+```
+
+## First Run Setup
+
+On first run, you'll be prompted to enter your API keys interactively:
+
+```bash
+zarz
+
+# Or set manually via environment variable
+export ANTHROPIC_API_KEY=sk-ant-...
+zarz
+```
+
+Your API keys are securely stored in `~/.zarz/config.toml`
+
+## Usage
+
+```bash
+# Start interactive chat (default)
+zarz
+
+# Quick one-shot question
+zarz --message "fix this bug"
+
+# Manage configuration
+zarz config --show     # Show current config
+zarz config --reset    # Reconfigure API keys
+```
+
+## Features
+
+- Interactive chat with AI (Claude, GPT & GLM models)
+- Real-time streaming responses
+- Automatic API key management
+- File operations & code editing
+- Symbol search & context detection
+- MCP (Model Context Protocol) support
+- Cross-platform (Windows, Linux, macOS)
+
+## Supported AI Providers
+
+- **Anthropic Claude** - Best for coding and agents
+- **OpenAI GPT** - Multimodal capabilities
+- **GLM (Z.AI)** - Cost-effective coding with 200K context ($3/month)
+
+See [GLM-PROVIDER.md](GLM-PROVIDER.md) for detailed GLM setup and usage.
+
+## Requirements
+
+- Node.js 14.0.0 or higher
+- Rust toolchain (auto-installed if missing)
+- API key: Anthropic Claude, OpenAI, or GLM (Z.AI)
+
+## License
+
+Proprietary - All rights reserved
+
+© 2025 zarzet. This software is licensed for personal use only.

package/bin/zarz.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Determine the binary path based on platform
+function getBinaryPath() {
+  const rootDir = path.join(__dirname, '..');
+  const platform = process.platform;
+
+  let binaryName = 'zarzcli';
+  if (platform === 'win32') {
+    binaryName += '.exe';
+  }
+
+  const binaryPath = path.join(rootDir, 'target', 'release', binaryName);
+
+  return binaryPath;
+}
+
+// Check if binary exists, if not, build it
+function ensureBinaryExists(binaryPath) {
+  if (!fs.existsSync(binaryPath)) {
+    console.error('Binary not found. Building...');
+    console.error('This may take a few minutes on first run.');
+
+    const { execSync } = require('child_process');
+    const rootDir = path.join(__dirname, '..');
+
+    try {
+      execSync('cargo build --release', {
+        cwd: rootDir,
+        stdio: 'inherit'
+      });
+    } catch (error) {
+      console.error('Failed to build binary. Make sure Rust and Cargo are installed.');
+      console.error('Install Rust from: https://rustup.rs/');
+      process.exit(1);
+    }
+  }
+}
+
+// Main execution
+function main() {
+  const binaryPath = getBinaryPath();
+
+  // Ensure binary exists
+  ensureBinaryExists(binaryPath);
+
+  // Check if binary exists after build attempt
+  if (!fs.existsSync(binaryPath)) {
+    console.error(`Binary not found at: ${binaryPath}`);
+    console.error('Please run: cargo build --release');
+    process.exit(1);
+  }
+
+  // Forward all arguments to the binary
+  const args = process.argv.slice(2);
+
+  // Spawn the binary
+  const child = spawn(binaryPath, args, {
+    stdio: 'inherit',
+    env: process.env
+  });
+
+  // Handle exit
+  child.on('exit', (code) => {
+    process.exit(code || 0);
+  });
+
+  // Handle errors
+  child.on('error', (error) => {
+    console.error('Failed to start zarz:', error.message);
+    process.exit(1);
+  });
+}
+
+// Run main
+main();

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "zarz",
+  "version": "0.3.1-alpha",
+  "description": "Fast AI coding assistant for terminal built with Rust",
+  "main": "bin/zarz.js",
+  "bin": {
+    "zarz": "./bin/zarz.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "build": "cargo build --release",
+    "test": "cargo test"
+  },
+  "keywords": [
+    "ai",
+    "coding-assistant",
+    "cli",
+    "claude",
+    "codex",
+    "gpt",
+    "anthropic",
+    "openai",
+    "rust"
+  ],
+  "author": "zarzet",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zarzet/zarzcli.git"
+  },
+  "private": false,
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "files": [
+    "bin/",
+    "scripts/",
+    "src/",
+    "Cargo.toml",
+    "Cargo.lock",
+    "README.md",
+    "QUICKSTART.md",
+    "MODELS.md"
+  ],
+  "dependencies": {},
+  "devDependencies": {},
+  "preferGlobal": true
+}

package/scripts/postinstall.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function checkRustInstalled() {
+  try {
+    execSync('cargo --version', { stdio: 'ignore' });
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+
+function getBinaryPath() {
+  const rootDir = path.join(__dirname, '..');
+  const platform = process.platform;
+
+  let binaryName = 'zarzcli';
+  if (platform === 'win32') {
+    binaryName += '.exe';
+  }
+
+  return path.join(rootDir, 'target', 'release', binaryName);
+}
+
+function main() {
+  console.log('Installing ZarzCLI...');
+
+  // Check if Rust is installed
+  if (!checkRustInstalled()) {
+    console.log('');
+    console.log('WARNING: Rust/Cargo not found!');
+    console.log('ZarzCLI requires Rust to build the native binary.');
+    console.log('');
+    console.log('Please install Rust from: https://rustup.rs/');
+    console.log('');
+    console.log('After installing Rust, run: npm install');
+    console.log('');
+    process.exit(0); // Don't fail install, just warn
+  }
+
+  const binaryPath = getBinaryPath();
+
+  // Check if binary already exists
+  if (fs.existsSync(binaryPath)) {
+    console.log('Binary already built. Skipping build.');
+    console.log('');
+    console.log('ZarzCLI installed successfully!');
+    console.log('Run "zarz" to start.');
+    return;
+  }
+
+  // Build the binary
+  console.log('Building native binary...');
+  console.log('This may take a few minutes on first install.');
+  console.log('');
+
+  try {
+    const rootDir = path.join(__dirname, '..');
+
+    execSync('cargo build --release', {
+      cwd: rootDir,
+      stdio: 'inherit'
+    });
+
+    console.log('');
+    console.log('ZarzCLI installed successfully!');
+    console.log('');
+    console.log('Quick Start:');
+    console.log('  1. Set API key: export ANTHROPIC_API_KEY=sk-ant-...');
+    console.log('  2. Run: zarz');
+    console.log('');
+    console.log('See QUICKSTART.md for more information.');
+    console.log('');
+
+  } catch (error) {
+    console.error('');
+    console.error('Build failed!');
+    console.error('');
+    console.error('Please make sure:');
+    console.error('  1. Rust and Cargo are installed: https://rustup.rs/');
+    console.error('  2. You have an internet connection (to download dependencies)');
+    console.error('');
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();