@entrydesk/cli

EntryDesk CLI

Command-line client for EntryDesk. Includes interactive chat, tool output rendering, and scripting-friendly JSON output.

Installation

# Install the CLI
npm install -g @entrydesk/cli

# Install Playwright globally (required for browser-based login)
npm install -g playwright

# Install Chromium browser and system dependencies
npx playwright install chromium --with-deps

The Playwright browser is required for the browser-based OAuth login flow (entrydesk login).

Quick Start

Build and run from the repo:

pnpm --filter @entrydesk/cli build
pnpm --filter @entrydesk/cli start -- chat -i

Interactive chat is also the default when no command is provided:

entrydesk

Authentication

entrydesk login
entrydesk login --google
entrydesk login --email <email> --password <password>
entrydesk status
entrydesk logout

Credential Storage

By default, EntryDesk CLI stores credentials in the OS keychain when available. If the keychain is unavailable, it falls back to an encrypted file at ~/.entrydesk/profiles/<profile>/credentials.json.

To force file storage (for example, in CI), set ENTRYDESK_FORCE_FILE_STORAGE=true.

Login requires HTTPS by default. For local development against an HTTP API, set ENTRYDESK_ALLOW_INSECURE_LOGIN=true.

Chat

entrydesk chat -m "Hello" --model <model>
entrydesk chat -a <agent>
entrydesk chat -c 1 -m "Follow up"
entrydesk chat -i
entrydesk chat -i --web-search             # Enable web search
entrydesk chat -i --no-sandbox             # Disable sandbox
entrydesk chat -i --connectors id1,id2     # Use specific connectors

Piping input and output:

echo "Hello" | entrydesk chat --model <model>
entrydesk chat -m "Hi" --model <model> --plain
entrydesk chat -m "Hi" --model <model> --output stream-json

Browse Resources

entrydesk workspaces
entrydesk workspaces switch <workspaceId>  # Switch to a workspace
entrydesk models
entrydesk agents
entrydesk connectors
entrydesk skills
entrydesk chats
entrydesk chats 1

MCP Server

entrydesk mcp
entrydesk mcp --http --port 3100

Skills Management

entrydesk skills                    # List all available skills
entrydesk skills --me               # List only skills created by you
entrydesk skills upload my-skill.zip # Upload a skill zip file
entrydesk skills upload ./my-skill  # Upload a skill folder (auto-zipped)
entrydesk skills delete skill-123   # Delete a skill you own
entrydesk skills --json             # Output in JSON format

Budget Management

entrydesk budget                    # Show current workspace budget
entrydesk budget get                # Get workspace budget
entrydesk budget set 100.00         # Set workspace budget to $100
entrydesk budget clear              # Remove workspace budget
entrydesk budget --json             # Output in JSON format

Usage Statistics

entrydesk usage                     # Show usage by all users, sorted by cost
entrydesk usage --limit 10          # Show top 10 users
entrydesk usage --sort-by operations # Sort by operation count
entrydesk usage --json              # Output in JSON format

Agents Management

entrydesk agents                    # List available agents
entrydesk agents --json             # Output in JSON format
entrydesk agents create --name "My Agent" --description "..." --system-prompt "..." --model-id <modelId>
entrydesk agents update <agentId> --name "New Name" --description "..." --system-prompt "..." --model-id <modelId>
entrydesk agents delete <agentId>

Configuration

entrydesk config
entrydesk config set apiUrl http://localhost:3200
entrydesk config set hubUrl http://localhost:3000
entrydesk config unset apiUrl

Profiles

entrydesk profile                      # List profiles
entrydesk profile create staging       # Create a profile
entrydesk profile use staging          # Switch active profile
entrydesk profile show staging         # Show profile details
entrydesk profile clone default staging # Clone config defaults (no credentials)
entrydesk profile delete staging

# Run a single command against a specific profile without switching
entrydesk status --profile staging
entrydesk chat -i --profile staging

Development

pnpm --filter @entrydesk/cli dev
pnpm --filter @entrydesk/cli lint
pnpm --filter @entrydesk/cli typecheck