Configuration Commands
Manage environment variables, secrets, and API keys from the CLI.
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 listGet a Variable
agentuity cloud env get NODE_ENVSet a Variable
agentuity cloud env set NODE_ENV production
agentuity cloud env set API_URL https://api.example.comDelete a Variable
agentuity cloud env delete OLD_CONFIGPush from Local File
Upload variables from .env.production (or .env) to cloud:
agentuity cloud env pushThis filters out AGENTUITY_ prefixed keys automatically.
Pull to Local File
Download cloud variables to .env.production:
# Merge with local (local values take priority)
agentuity cloud env pull
# Overwrite local with cloud values
agentuity cloud env pull --forceImport from File
agentuity cloud env import .env.stagingSecrets vs Environment Variables
Use cloud secret for sensitive values like API keys and database passwords. Use cloud env for non-sensitive configuration like feature flags and URLs.
Secrets
Manage sensitive values like API keys and tokens. Commands mirror cloud env.
List Secrets
agentuity cloud secret listGet a Secret
agentuity cloud secret get API_KEYSet a Secret
agentuity cloud secret set API_KEY "sk_live_..."
agentuity cloud secret set DATABASE_URL "postgresql://..."Delete a Secret
agentuity cloud secret delete OLD_TOKENPush/Pull
# Push from local file
agentuity cloud secret push
# Pull to local file
agentuity cloud secret pull
agentuity cloud secret pull --forceImport from File
agentuity cloud secret import .env.secretsSDK Access
Access secrets in agents via process.env:
const apiKey = process.env.API_KEY;Secrets are injected at runtime and never logged.
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 --confirmSave 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 listGet 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 them in your .env as AGENTUITY_SDK_KEY:
AGENTUITY_SDK_KEY=agt_...Next Steps
- Storage Commands: Manage KV, S3, Vector, Database, and Streams
- Deployment Commands: Deploy and manage your agents
- Development Commands: Local development workflow
Need Help?
Join our Community for assistance or just to hang with other humans building agents.
Send us an email at hi@agentuity.com if you'd like to get in touch.
Please Follow us on
If you haven't already, please Signup for your free account now and start building your first agent!