Personal Assistant Quick Start

Installation

Interactive installer (recommended)

bash <(curl -fsSL "https://raw.githubusercontent.com/open-gitagent/gitagent/main/install.sh?$(date +%s)")

Installs globally via npm, walks through API key setup, launches web UI at http://localhost:3333

Manual install

npm install -g @open-gitagent/gitagent
mkdir ~/assistant && cd ~/assistant && git init
gitagent --voice --dir .

Setup Modes

Mode	Description	Keys
Install with LYZR	Easiest — uses Lyzr AI Studio cloud	`LYZR_API_KEY`
Voice + Text	Real-time voice + text chat	`OPENAI_API_KEY` (or `GEMINI_API_KEY` for `--voice gemini`)
Text Only	Terminal REPL, no voice or web UI	`ANTHROPIC_API_KEY`
Advanced Setup	Choose voice adapter, model, port, integrations	varies

Auto-scaffold on first run: gitagent --dir ~/my-project 'Explain this project' auto-creates agent.yaml, SOUL.md, and memory/ in the target directory.

Quick Examples

# Single-shot query
gitagent --dir ~/my-project "Build a REST API for user management"

# With voice UI
gitagent --voice --dir ~/assistant

# Local repo mode — clone, fix, commit to session branch
gitagent --repo https://github.com/org/repo --pat ghp_xxx "Fix the login bug"

CLI Reference

All flags, REPL commands, and the plugin CLI

Web & Voice

Run the full browser interface with real-time voice

Messaging

Connect Telegram, WhatsApp, and phone

Models & Providers

Configure 12+ LLM providers and custom endpoints

Telemetry CLI

Getting Started

SDK

Personal Assistant

Configuration

Capabilities

Data & Integrations

Enterprise

Personal Assistant Quick Start

Installation

Interactive installer (recommended)

Manual install

Setup Modes

Quick Examples

CLI Reference

Web & Voice

Messaging

Models & Providers

​Installation

​Interactive installer (recommended)

​Manual install

​Setup Modes

​Quick Examples

CLI Reference

Web & Voice

Messaging

Models & Providers

Installation

Interactive installer (recommended)

Manual install

Setup Modes

Quick Examples