Skip to main content
The primary way to run GitAgent. Starts an interactive REPL in your terminal.

​
Basic Usage

gitagent --dir ~/assistant

​
All Flags

FlagShortDescriptionDefault
--dir <path>-dAgent directorycurrent working directory
--model <provider:model>-mOverride model from agent.yamlfrom agent.yaml
--prompt "text"-pRun a single prompt (non-interactive)—
--env <name>-eLoad config/<name>.yaml environment overridesdefault
--voice-vStart Web UI + voice server at localhost:3333—
--sandbox-sRun agent inside an E2B cloud VMfalse
--sandbox-repo <url>—Clone a repo into the sandbox—
--sandbox-token <tok>—Git token for cloning (falls back to GITHUB_TOKEN / GIT_TOKEN)—
--repo <url>—Work on a remote git repo locally—
--pat <token>—Personal access token for --repo—
--session <branch>—Session branch name for --repo modeauto-generated

​
REPL Commands

CommandDescription
/quit or /exitExit the session
/memoryView the current memory file
/skillsList all installed skills
/learnedShow learned skills with confidence, usage, and success stats
/tasksShow currently active tasks
/pluginsList loaded plugins and what they provide
/skill:<name>Execute a specific skill (e.g. /skill:deploy)

​
Plugin CLI

gitagent plugin install https://github.com/user/plugin-repo
gitagent plugin install ./local/path --name my-plugin --force
gitagent plugin list --dir ~/assistant
gitagent plugin enable my-plugin --dir ~/assistant
gitagent plugin disable my-plugin --dir ~/assistant
gitagent plugin remove my-plugin --dir ~/assistant
gitagent plugin init my-plugin --dir ~/assistant

Personal Assistant Quick Start

Install GitAgent and run your first session

Web & Voice

Run the full browser interface with real-time voice

Messaging

Connect Telegram, WhatsApp, and phone

Plugins

Extend GitAgent with tools, hooks, skills, and memory layers