adk-code

# adk-code

> **An intelligent CLI coding assistant powered by Google's ADK framework**

[![Go](https://img.shields.io/badge/Go-1.24+-00ADD8?style=flat-square&logo=go)](https://golang.org)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
[![GitHub Stars](https://img.shields.io/github/stars/raphaelmansuy/adk-code?style=flat-square)](https://github.com/raphaelmansuy/adk-code)


## What is adk-code?

`adk-code` is a **multi-model AI coding assistant** that runs directly in your terminal. Ask natural language questions about your code—it reads files, executes commands, makes edits, and runs searches autonomously.

### Key Features

- **🤖 Multi-Model Support**: Seamlessly switch between Gemini, OpenAI, and Vertex AI
- **🛠️ 30+ Built-in Tools**: File operations, code editing, execution, Google Search, HTTP fetch, agent discovery, and more
- **🔌 MCP Integration**: Unlimited extensibility via Model Context Protocol
- **💾 Session Persistence**: Maintain context across conversations with automatic history and token-aware compaction
- **🌐 Web Integration**: Google Search and HTTP fetch tools for research and content retrieval
- **⚡ Streaming Responses**: Real-time output as the model thinks and executes
- **🎨 Beautiful Terminal UI**: Rich formatting, colors, pagination, and interactive displays
- **📦 Zero External Dependencies**: No Langchain, Claude Code, or Cline baggage

## Quick Start

### Installation

#### Option A: Homebrew (macOS) — Recommended

The easiest way to install on macOS:

```bash
# Add the tap (one-time)
brew tap raphaelmansuy/adk-code

# Install adk-code
brew install adk-code

# Verify installation
adk-code --version
```

**Supported on:**

- macOS 10.13+ (High Sierra and later)
- Intel (x86_64) and Apple Silicon (M-series) Macs

**Update to latest:**

```bash
brew upgrade adk-code
```

**Uninstall:**

```bash
brew uninstall adk-code
```

See [homebrew-adk-code](https://github.com/raphaelmansuy/homeb