CLI Reference Overview

The Raindrop CLI provides commands to manage the entire lifecycle of LiquidMetal applications. Use these commands to authenticate, deploy applications, manage DNS zones, work with object storage, query logs, and integrate with AI coding assistants.

All commands follow the pattern raindrop <category> <command> [arguments] [flags].

Command Categories

• auth - Manage authentication and organizations
• build - Application lifecycle management
• dns - DNS zone and record management
• bucket - S3-compatible credential management
• object - Object storage operations
• logs - Log querying and streaming
• mcp - AI coding assistant integration
• annotation - Application metadata management
• query - Smart search and RAG operations

Authentication Commands

Manage authentication with the LiquidMetal platform and switch between organizations.

Command	Description	Key Flags	Example
auth login	Authenticate with LiquidMetal	None	raindrop auth login
auth logout	Remove authentication	None	raindrop auth logout
auth list	List authenticated organizations	-o, --output (table|json|text)	raindrop auth list --output json
auth select	Switch active organization	--organizationId	raindrop auth select org_123

See detailed documentation: raindrop auth

Build Commands

Manage application deployment, versioning, environment variables, and WorkOS integration.

Core Application Management

Command	Description	Key Flags	Example
build init	Initialize new project	-r, --root, -m, --manifest	raindrop build init
build generate	Generate code from manifest	-r, --root, -m, --manifest	raindrop build generate
build deploy	Deploy application	-s, --start, --no-watch, -a, --amend	raindrop build deploy --start
build status	Show application status	-o, --output, -v, --version-id	raindrop build status
build start	Start application	-a, --application, -v, --version-id	raindrop build start
build stop	Stop application	-a, --application, -v, --version-id	raindrop build stop
build list	List applications	-o, --output, --all	raindrop build list --all
build delete	Delete application version	-v, --version-id, --all, -f, --force	raindrop build delete --version-id v1
build validate	Validate manifest	-r, --root, -m, --manifest	raindrop build validate

Version Management

Command	Description	Key Flags	Example
build branch	Create version branch	--branch, -v, --version-id	raindrop build branch --branch feature-x
build checkout	Switch to version	None	raindrop build checkout v1.0.0
build sandbox	Mark version as sandbox	-v, --version-id	raindrop build sandbox
build unsandbox	Unmark version as sandbox	-v, --version-id	raindrop build unsandbox
build clone	Clone version	--target, -v, --version-id	raindrop build clone --target v2.0.0
build find	Find application versions	--limit, -a, --application	raindrop build find --limit 20

Environment Variables

Command	Description	Key Flags	Example
build env get	Get environment variable	-a, --application, -v, --version-id	raindrop build env get DATABASE_URL
build env set	Set environment variable	-a, --application, -v, --version-id	raindrop build env set API_KEY secret123

Tools

Command	Description	Key Flags	Example
build tools check	Validate manifest syntax	-r, --root, -m, --manifest	raindrop build tools check
build tools fmt	Format manifest	-r, --root, -m, --manifest	raindrop build tools fmt

WorkOS Integration

Command	Description	Key Flags	Example
build workos setup	Create WorkOS team	--admin-email, --name	raindrop build workos setup
build workos status	View WorkOS team info	-o, --output	raindrop build workos status
build workos invite	Invite user to team	--role	raindrop build workos invite user@example.com --role admin
build workos delete	Delete WorkOS integration	-f, --force	raindrop build workos delete --force
build workos env create	Create WorkOS environment	--name, --no-attach	raindrop build workos env create my-env
build workos env get	Get environment details	-o, --output	raindrop build workos env get my-app
build workos env set	Configure environment	--environment-id, --client-id, --api-key, etc.	raindrop build workos env set my-app --environment-id env_123 ...
build workos env list	List environments	-o, --output	raindrop build workos env list
build workos env delete	Remove environment config	None	raindrop build workos env delete my-app
build workos env attach	Attach environment to version	-v, --version-id	raindrop build workos env attach
build workos env detach	Detach environment	-v, --version-id	raindrop build workos env detach

See detailed documentation: raindrop build

DNS Commands

Create and manage DNS zones and records.

Zone Management

Command	Description	Key Flags	Example
dns create	Create DNS zone	-o, --output	raindrop dns create example.com
dns delete	Delete DNS zone	-f, --force	raindrop dns delete example.com --force
dns get	Get zone details	-o, --output	raindrop dns get example.com
dns list	List all zones	-o, --output	raindrop dns list

Record Management

Command	Description	Key Flags	Example
dns records create	Create DNS record	--name, --type, --value, --ttl, --priority	raindrop dns records create example.com --name www --type A --value 1.2.3.4
dns records delete	Delete DNS record	-f, --force	raindrop dns records delete example.com rec_123
dns records get	Get record details	-o, --output	raindrop dns records get example.com rec_123
dns records list	List zone records	--type, -o, --output	raindrop dns records list example.com --type A
dns records update	Update DNS record	--name, --value, --ttl, --priority	raindrop dns records update example.com rec_123 --value 5.6.7.8

DNS record types: A, AAAA, CNAME, MX, TXT, NS, SRV, PTR, CAA

Bucket Commands

Manage S3-compatible credentials for object storage buckets.

Command	Description	Key Flags	Example
bucket create-credential	Create S3 credentials	-o, --output	raindrop bucket create-credential my-bucket
bucket delete-credential	Delete S3 credentials	-f, --force	raindrop bucket delete-credential my-bucket AKIA...
bucket get-credential	Get S3 credentials	-o, --output	raindrop bucket get-credential my-bucket AKIA...
bucket list-credentials	List bucket credentials	-o, --output	raindrop bucket list-credentials my-bucket

Object Commands

Perform object storage operations on buckets.

Command	Description	Key Flags	Example
object get	Get object from bucket	-b, --bucket, -o, --output	raindrop object get myfile.txt --bucket my-bucket
object put	Put object into bucket	-b, --bucket, --content-type	raindrop object put myfile.txt ./local-file.txt --bucket my-bucket
object delete	Delete object from bucket	-b, --bucket, -f, --force	raindrop object delete myfile.txt --bucket my-bucket
object list	List objects in bucket	-b, --bucket, --prefix, -o, --output	raindrop object list --bucket my-bucket --prefix images/

Bucket version syntax: Specify version with #, e.g., --bucket my-bucket#versionId

Log Commands

Query historical logs or stream real-time logs from deployed applications.

Command	Description	Key Flags	Example
logs query	Query historical logs	-a, --application, -v, --version-id, --query, --start, --end, --limit	raindrop logs query --query "error" --start "1h ago"
logs tail	Stream real-time logs	-a, --application, -v, --version-id, --filter	raindrop logs tail --filter "error"

See detailed documentation: raindrop logs

MCP Commands

Integrate Raindrop with AI coding assistants using Model Context Protocol.

Command	Description	Requirements	Example
mcp status	Show MCP integration status	None	raindrop mcp status
mcp install-claude	Install Raindrop for Claude Code	Claude CLI installed	raindrop mcp install-claude
mcp install-gemini	Install Raindrop for Gemini CLI	Gemini CLI installed	raindrop mcp install-gemini
mcp install-goose	Install Raindrop for Goose	Goose installed	raindrop mcp install-goose

Installation features:

• Adds raindrop-mcp server to AI assistant configuration
• Creates slash commands/recipes:
  • /new-raindrop-app - Start new application development
  • /update-raindrop-app - Update existing applications
  • /reattach-raindrop-session - Resume previous sessions

Annotation Commands

Manage application metadata using Machine Resource Names (MRNs).

Command	Description	Key Flags	Example
annotation get	Get annotation by MRN	-f, --format	raindrop annotation get my-module:my-key:
annotation put	Create/update annotation	-o, --output	raindrop annotation put my-module:my-key: "My annotation"
annotation list	List annotations by prefix	-o, --output, -l, --limit	raindrop annotation list my-module

MRN format: annotation:app:version:module:item^key:

• Can use partial MRNs: my-module:my-key:
• Can use full MRNs: annotation:my-app:v1.0.0:my-module:my-key:
• Use - to read from stdin: raindrop annotation put my-module:key: - < file.txt

Query Commands

Perform smart search and RAG (Retrieval Augmented Generation) operations on smart buckets.

Command	Description	Key Flags	Example
query chunk-search	RAG search across buckets	-b, --buckets	raindrop query chunk-search "What is LiquidMetal?" --buckets bucket1 bucket2
query document	Chat with a document	-b, --bucket, --object-id	raindrop query document "Summarize this" --bucket my-bucket --object-id doc.pdf
query events	Query application events	-a, --application, -v, --version-id	raindrop query events
query reindex	Reindex bucket objects	-b, --bucket, --parallel, -d, --dry-run	raindrop query reindex --bucket my-bucket --parallel 5
query search	Natural language search	-b, --buckets, --page, --request-id	raindrop query search "Find documents about X" --buckets my-bucket

Common Flag Patterns

Most commands support these common flags:

Flag	Description	Values	Default
-o, --output	Output format	text, json, table	Varies by command
-r, --root	Project root directory	Path	Current directory
-m, --manifest	Manifest file name	Filename	raindrop.manifest
-a, --application	Application name	String	From manifest
-v, --version-id	Version ID	String	From config
-f, --force	Skip confirmation prompts	Boolean	false

Getting Help

View help for any command:

raindrop --help
raindrop <category> --help
raindrop <category> <command> --help

Examples:

raindrop build --help
raindrop dns records create --help

Exit Codes

• 0 - Success
• 1 - General error (validation failures, file not found, etc.)
• 2 - Invalid arguments
• 5 - Resource not found (status command only)