CLI Reference

The AgentLift CLI (agentlift-cli) is the primary tool for managing agents from the command line.

Installation

pip install agentlift-cli

Commands

agentlift login

Authenticate with your AgentLift account. Opens a browser for Google OAuth or prompts for email/password.

agentlift login

agentlift init

Scaffold a new agent project with a config file and prompt template.

agentlift init <name> [--template <template>]

Arguments:

Argument	Description
name	Name for the new agent project

Options:

Option	Description	Default
--template	Starter template to use	hello-world

agentlift push

Push the agent configuration to the AgentLift platform. Creates a new version.

agentlift push [--team <team>]

Options:

Option	Description
--team	Team to push to (required if you belong to multiple teams)

agentlift deploy

Deploy the latest pushed version to a live endpoint.

agentlift deploy [--team <team>] [--version <version>]

Options:

Option	Description
--team	Target team
--version	Specific version to deploy (defaults to latest)

agentlift dev

Start a local development server with hot reload. Changes to agent.yaml or prompt files are picked up automatically.

agentlift dev [--port <port>]

Options:

Option	Description	Default
--port	Local server port	8000

agentlift logs

View agent traces and logs in real time.

agentlift logs [--agent <agent>] [--follow]

Options:

Option	Description
--agent	Filter logs by agent name
--follow	Stream logs in real time