Agent Engine CLI

A command-line interface to manage Agent Engine.

Installation

# With uv (recommended)
uv tool install agent-engine-cli --python 3.11

# With pip (requires Python 3.11+)
pip install agent-engine-cli

After installation, the ae command is available globally:

ae --help

Run Without Installing

python -m agent_engine_cli --help

Development Setup

1. Install uv (if you haven't already):

   curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone the repo and install dependencies:

   git clone https://github.com/mmontan/agent-engine-cli.git
   cd agent-engine-cli
   uv sync

3. Run the CLI locally:

   uv run ae --help

Chat with an Agent

Start an interactive chat session with a deployed agent:

# Basic usage
ae -p PROJECT_ID -l us-central1 chat AGENT_ID

# With custom user ID
ae -p PROJECT_ID -l us-central1 chat AGENT_ID --user my-user-id

# With debug logging enabled
ae -p PROJECT_ID -l us-central1 chat AGENT_ID --debug

Development

To run tests:

uv pip install -e ".[dev]" # or just use the dev-dependencies if using a uv-managed lockfile workflow
# If using pure uv sync:
uv sync
uv run pytest