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.
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.
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.
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.
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.
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):