simultaneous-cli 0.1.0

CLI for Simultaneous SDK

Simultaneous CLI

Command line interface for Simultaneous SDK.

Installation

# Install CLI separately (optional)
pip install -e ./cli

# Or install with CLI extras
pip install -e ".[cli]"

Configuration

The CLI uses the hosted API at https://simultaneous-api.fly.dev by default. You can override this with:

export SIMULTANEOUS_API_URL=https://your-api-url.com
export SIMULTANEOUS_FRONTEND_URL=https://your-frontend-url.com

Local Development

To use a locally running API:

# Linux/Mac
export SIMULTANEOUS_API_URL="http://localhost:8000"

# Windows (PowerShell)
$env:SIMULTANEOUS_API_URL="http://localhost:8000"

# Windows (CMD)
set SIMULTANEOUS_API_URL=http://localhost:8000

Then start the API locally:

cd api
python -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload

See LOCAL_DEV_SETUP.md in the project root for detailed local development setup.

Usage

Authentication

# Sign up
sim auth signup

# Sign in (prompts for credentials)
sim auth signin

# Sign in via web browser (opens browser for OAuth redirect flow)
sim auth signin --web

# Or simply run without credentials to use web flow
sim auth signin

# Check auth status
sim auth status

# Show current user
sim auth whoami

# Sign out
sim auth signout

Organization Management

# Create organization
sim orgs create <org-name>

# List organizations
sim orgs list

Project Management

# Create project
sim projects create <project-name> [--slug <slug>]

# List projects
sim projects list [--archived]

# Get project details
sim projects get <project-id>

# Delete project
sim projects delete <project-id>

Agent Management

# Create agent
sim agents create <project-id> \
  --name <agent-name> \
  --script <script-content> \
  --script-file <path-to-script> \
  --provider-project-id <browserbase-project-id> \
  [--description <description>] \
  [--env-vars <json-encoded-env-vars>] \
  [--context-id <context-id>] \
  [--extension-id <extension-id>] \
  [--region <region>] \
  [--timeout-sec <seconds>]

# List agents in a project
sim agents list <project-id> [--active-only]

# Get agent details
sim agents get <project-id> <agent-id>

# Delete agent
sim agents delete <project-id> <agent-id>

Running Agents

# Run an agent
sim run <agent-name> \
  --project-id <project-id> \
  --agent-id <agent-id> \
  --params '{"key": "value"}'

Marketplace

# Publish agent to marketplace
sim marketplace publish <agent-id> [--project-id <project-id>] [--public/--private]

# List marketplace agents
sim marketplace list

# Deploy agent from marketplace
sim marketplace deploy <marketplace-agent-id> <project-id>

Deployment

# Deploy agent to cloud (Modal - placeholder for future implementation)
sim deploy agent <project-id> <agent-id>

Setup

1. Create a .env file in the project root with (optional, for Supabase fallback):

SUPABASE_URL=https://your-project-id.supabase.co
SUPABASE_KEY=your-anon-public-key

You can find these in your Supabase Dashboard: Settings → API

Note: The CLI primarily uses the hosted API at https://simultaneous-api.fly.dev. The Supabase credentials are only used as a fallback for authentication.

Development

# Run CLI in development mode
python -m cli.main