Agentuity Documentation

These CLI commands help you manage configuration values for your deployed agents.

Cloud Prefix Required

All configuration commands require the cloud prefix. For example: agentuity cloud env list

Environment Variables

Manage non-sensitive configuration values.

List Variables

agentuity cloud env list

Get a Variable

agentuity cloud env get NODE_ENV

Set a Variable

agentuity cloud env set NODE_ENV production
agentuity cloud env set API_URL https://api.example.com

Delete a Variable

agentuity cloud env delete OLD_CONFIG

Push from Local File

Upload variables from .env to cloud:

agentuity cloud env push

This filters out AGENTUITY_ prefixed keys automatically.

Pull to Local File

Download cloud variables to .env:

# Merge with local (local values take priority)
agentuity cloud env pull
 
# Overwrite local with cloud values
agentuity cloud env pull --force

Import from File

agentuity cloud env import .env.staging

Secrets use cloud env

There is no separate cloud secret command. Store sensitive values with agentuity cloud env set --secret; cloud env list, get, delete, push, pull, and import handle both environment variables and secrets.

Secrets

Manage sensitive values like API keys and tokens through cloud env.

List Secrets

agentuity cloud env list --secrets

Get a Secret

agentuity cloud env get API_KEY

Set a Secret

agentuity cloud env set API_KEY "sk_live_..." --secret
agentuity cloud env set DATABASE_URL "postgresql://..." --secret

Delete a Secret

agentuity cloud env delete OLD_TOKEN

Push/Pull

# Push from local file
agentuity cloud env push
 
# Pull to local file
agentuity cloud env pull
agentuity cloud env pull --force

Import from File

agentuity cloud env import .env.secrets

In agents: Access secrets via process.env.API_KEY. Secrets are injected at runtime and never logged.

Organization-Level Configuration

Set environment variables and secrets at the organization level to share them across all projects in that organization. Use the --org flag with cloud env commands.

Set Org-Level Variables

# Set using your default org
agentuity cloud env set DATABASE_URL "postgresql://..." --org
 
# Set for a specific org
agentuity cloud env set DATABASE_URL "postgresql://..." --org org_abc123

Set Org-Level Secrets

# Set shared secret for default org
agentuity cloud env set SHARED_API_KEY "sk_..." --secret --org
 
# Set for specific org
agentuity cloud env set SHARED_API_KEY "sk_..." --secret --org org_abc123

List Org-Level Values

# List org environment variables
agentuity cloud env list --org
 
# List org secrets
agentuity cloud env list --secrets --org

Get/Delete Org-Level Values

# Get an org variable
agentuity cloud env get DATABASE_URL --org
 
# Delete an org secret
agentuity cloud env delete OLD_KEY --org

Inheritance

Organization-level values are inherited by all projects in that organization. Project-level values take precedence over organization-level values when both are set.

Default Organization

Set a default organization with agentuity auth org select to avoid specifying --org on every command. If you use multiple accounts or organizations, see CLI Profiles for separate defaults.

API Keys

Create and manage API keys for programmatic access to your project.

Create an API Key

# With 1 year expiration
agentuity cloud apikey create --name "Production Key" --expires-at 1y
 
# With 30 day expiration
agentuity cloud apikey create --name "Short-lived Key" --expires-at 30d
 
# With specific date
agentuity cloud apikey create --name "Q1 Key" --expires-at 2026-03-31T23:59:59Z
 
# Skip confirmation prompt
agentuity cloud apikey create --name "CI/CD Key" --expires-at 90d --confirm

Save Your Key

The API key value is shown only once during creation. Copy it immediately; you cannot retrieve it later.

List API Keys

agentuity cloud apikey list

Get API Key Details

agentuity cloud apikey get <key-id>

This shows metadata (name, expiration) but not the key value.

Delete an API Key

agentuity cloud apikey delete <key-id>

Using API Keys

API keys authenticate requests to Agentuity APIs. Store project API keys in your .env as AGENTUITY_SDK_KEY:

AGENTUITY_SDK_KEY=agt_...

For the difference between project SDK keys and CLI login credentials, see Agentuity Keys.

Next Steps

Storage Commands: Manage KV, S3, Vector, Database, and Streams
Deployment Commands: Deploy and manage your agents
Development Commands: Local development workflow