codingbuddy

# CodingBuddy

An open-source, multi-model AI coding agent for the terminal. Written in Rust.

Connect any LLM — DeepSeek, OpenAI, Anthropic, Google, Groq, Ollama, OpenRouter — and get a production-grade coding assistant with tool execution, planning, code search, and safety guardrails.

## Why CodingBuddy?

- **Any model, any provider.** 7 providers preconfigured. Any OpenAI-compatible endpoint works.
- **Fast.** Rust binary, no runtime dependencies. Sub-100ms startup with profiling.
- **Safe.** 0 production unwraps. Tree-sitter bash AST analysis, 4-stage permission system, default deny rules.
- **Smart.** 7-strategy fuzzy editing, coordinator mode for parallel agents, per-turn RAG, doom loop detection.
- **Extensible.** MCP servers, 12 lifecycle hooks, custom skills with model/effort metadata, SendMessage for inter-agent communication.

## Installation

### One-liner (recommended)

**macOS / Linux:**
```bash
curl -fsSL https://raw.githubusercontent.com/aloundoye/codingbuddy/main/scripts/install.sh | bash
```

**Windows (PowerShell):**
```powershell
irm https://raw.githubusercontent.com/aloundoye/codingbuddy/main/scripts/install.ps1 | iex
```

The installer downloads the correct binary for your platform, verifies the SHA-256 checksum, and adds it to your PATH.

### Other methods

**npm** (any platform with Node.js):
```bash
npm install -g codingbuddy
```

**Homebrew** (macOS / Linux):
```bash
brew install aloundoye/tap/codingbuddy
```

**From source** (requires Rust 1.94.1+):
```bash
cargo build --release --bin codingbuddy
# Binary at target/release/codingbuddy — move it to a directory in your PATH
```

### Installer options

The install scripts accept flags to customize behavior:

```bash
# Install a specific version
curl -fsSL .../install.sh | bash -s -- --version v0.3.0

# Install to a custom directory
curl -fsSL .../install.sh | bash -s -- --install-dir ~/.local/bin

# Dry run (show what would happen)
curl -fsSL .../install.sh | bash -s -- --dry-run
```

On Win