> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lyzr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> Run GitAgent's interactive terminal REPL with flags, REPL commands, and the plugin CLI.

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

## Basic Usage

```bash theme={null}
gitagent --dir ~/assistant
```

## All Flags

| Flag                       | Short | Description                                                      | Default                   |
| -------------------------- | ----- | ---------------------------------------------------------------- | ------------------------- |
| `--dir <path>`             | `-d`  | Agent directory                                                  | current working directory |
| `--model <provider:model>` | `-m`  | Override model from agent.yaml                                   | from agent.yaml           |
| `--prompt "text"`          | `-p`  | Run a single prompt (non-interactive)                            | —                         |
| `--env <name>`             | `-e`  | Load `config/<name>.yaml` environment overrides                  | default                   |
| `--voice`                  | `-v`  | Start Web UI + voice server at localhost:3333                    | —                         |
| `--sandbox`                | `-s`  | Run agent inside an E2B cloud VM                                 | false                     |
| `--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` mode                            | auto-generated            |

## REPL Commands

| Command            | Description                                                   |
| ------------------ | ------------------------------------------------------------- |
| `/quit` or `/exit` | Exit the session                                              |
| `/memory`          | View the current memory file                                  |
| `/skills`          | List all installed skills                                     |
| `/learned`         | Show learned skills with confidence, usage, and success stats |
| `/tasks`           | Show currently active tasks                                   |
| `/plugins`         | List loaded plugins and what they provide                     |
| `/skill:<name>`    | Execute a specific skill (e.g. `/skill:deploy`)               |

## Plugin CLI

```bash theme={null}
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
```

<CardGroup cols={2}>
  <Card title="Personal Assistant Quick Start" icon="rocket" href="/open-source/gitagent/personal-assistant/quickstart">
    Install GitAgent and run your first session
  </Card>

  <Card title="Web & Voice" icon="browser" href="/open-source/gitagent/personal-assistant/web-voice">
    Run the full browser interface with real-time voice
  </Card>

  <Card title="Messaging" icon="plug" href="/open-source/gitagent/personal-assistant/messaging">
    Connect Telegram, WhatsApp, and phone
  </Card>

  <Card title="Plugins" icon="plug" href="/open-source/gitagent/capabilities/plugins">
    Extend GitAgent with tools, hooks, skills, and memory layers
  </Card>
</CardGroup>