Quickstart.

GemCode is an open-source, local-first coding agent built by Veoksha. It serves as a powerful alternative to Claude Code, combining Google Gemini with the Agent Development Kit (ADK) to work safely inside your repositories.

// 1. Install via pip (Python 3.11+ required)

$ pip install gemcode

// 2. Set your Google API Key

$ export GOOGLE_API_KEY="your_api_key"

// 3. Run inside any repository

$ gemcode -C ./my-project

Modes of Use

Mode

Description

One-shot CLI

gemcode -C repo "prompt" — Scripts, CI-style runs, quick questions.

REPL

gemcode -C repo (TTY, no prompt arg) — Long sessions, slash commands, exploration.

TUI

Same as REPL with GEMCODE_TUI=1 — Scrollback, styled output, slash completion menu.

IDE

gemcode ide --stdio — VS Code extension native bridge.

Kaira

gemcode kaira — Background queue of independent agent jobs.

Live audio

gemcode live-audio — Voice → Gemini Live.