Skip to main content
Flags and arguments for every guava command. For an overview, project targeting, and configuration, see the CLI overview.

guava login

Authenticate the CLI with Guava.

guava logout

Log the CLI out of Guava.

guava create

Create a new Guava project. Any unset flag is prompted interactively. Without a TTY (or with —no-prompt), missing required flags error and the rest fall back to the defaults noted in —help. The base image sets the runtime. Python projects get main.py and pyproject.toml, and dependencies are installed with uv sync. TypeScript/Node projects get main.ts and package.json; npm install is offered interactively, otherwise install dependencies yourself. Both also get README.md, guava-docs.md (a reference for AI coding assistants), and guava.toml. Outbound projects also create their campaign on the server. Passing an inbound-only flag with —direction outbound (or vice versa) is an error.
Inbound options (with —direction inbound) Outbound options (with —direction outbound)

guava run

Run the agent locally. The runtime comes from guava.toml’s base_image, or is inferred from pyproject.toml / package.json if there’s no config. Python projects run uv run main.py; Node projects run node --import tsx main.ts and need npm install first.

guava deploy

Deploy and manage deployments.

guava deploy up

Deploy the project.

guava deploy scale

Scale a running deployment to N replicas (1-20).

guava deploy down

Stop a deployment.

guava deploy purge

Permanently delete every trace of a project (deployments, images, bundles, build history, DB records). This cannot be undone.

guava deploy list

List all deployments.
Aliases: ls

guava deploy status

Get deployment status.

guava deploy logs

Get runtime logs from the running deployment.

guava deploy build-logs

Get build logs (returns a signed URL).

guava deploy changed

Check if project code has changed since last deploy.

guava numbers

Manage phone numbers.

guava numbers list

List owned phone numbers.
Aliases: ls

guava numbers buy

Buy a phone number and attach it to this project. The number is saved to guava.toml, and is available to the agent as $GUAVA_AGENT_NUMBER after the next deploy.

guava conversations

Browse conversations (calls).

guava conversations list

List conversations.
Aliases: ls

guava conversations get

Show conversation details.

guava conversations transcript

Show conversation transcript.

guava conversations recording

Download conversation recording (WAV).

guava org

Manage organizations.

guava org list

List organizations you belong to.
Aliases: ls

guava org use

Switch to a different organization. The active org determines which numbers, deployments, conversations, and campaigns the other commands act on.

guava campaigns

Manage outbound campaigns.

guava campaigns list

List outbound campaigns.
Aliases: ls

guava campaigns show

Show campaign details and status counts.

guava campaigns pause

Pause a campaign.

guava campaigns resume

Resume a paused campaign.

guava campaigns delete

Delete a campaign.

guava campaigns add-contacts

Add contacts to a campaign from a file. Each contact requires a phone_number field (E.164, e.g. +15555550100). Every other field becomes an entry in the contact’s data. Formats (dispatched by extension):

guava webrtc

Manage WebRTC codes.

guava webrtc create-code

Create a WebRTC code and print it.

guava webrtc create-client-token

Create a single-use client token for a WebRTC code and print it.

guava widget

Generate an embeddable web call widget.

guava say

Generate text-to-speech (TTS) audio from input.

guava update

Update project configuration.

guava self-upgrade

Upgrade the guava CLI to the latest version.

guava export-cli-schema

Print a JSON description of every command.