.env.example

# Optional: protect the proxy so only your services can call it
# CURSOR_BRIDGE_API_KEY=your-secret-key

# Optional: Cursor access token for spawned agent/ACP (automation). Alias: CURSOR_AUTH_TOKEN
# CURSOR_API_KEY=

# Optional: Cursor CLI path (default: agent)
# CURSOR_AGENT_BIN=agent

# Optional: bind and port
# CURSOR_BRIDGE_HOST=127.0.0.1
# CURSOR_BRIDGE_PORT=8765

# Optional: workspace base for Cursor CLI (default: current working directory).
# When CURSOR_BRIDGE_CHAT_ONLY_WORKSPACE=false, X-Cursor-Workspace must be under this directory.
# CURSOR_BRIDGE_WORKSPACE=/path/to/your/project

# Ignored — proxy is always chat-only (ask mode); documented for discoverability only.
# CURSOR_BRIDGE_MODE=ask

# Optional: default model when request doesn't specify one
# CURSOR_BRIDGE_DEFAULT_MODEL=auto

# Optional: timeout per completion in ms
# CURSOR_BRIDGE_TIMEOUT_MS=300000

# Optional: enable Cursor Max Mode (larger context, more tool calls). Works when using
# CURSOR_AGENT_NODE/SCRIPT or Windows .cmd layout (agent.cmd with node.exe + index.js in same dir).
# CURSOR_BRIDGE_MAX_MODE=true

# Optional: pool of configuration directories for multiple accounts (comma-separated).
# Alias: CURSOR_ACCOUNT_DIRS. Auto-discovers ~/.cursor-api-proxy/accounts when unset.
# CURSOR_CONFIG_DIRS=/Users/alice/Library/Application Support/cursor-agent,/Users/bob/Library/Application Support/cursor-agent

# Optional: when true and CURSOR_CONFIG_DIRS is set, run each account on a separate port
# CURSOR_BRIDGE_MULTI_PORT=true

# Optional: send prompt via stdin instead of argv (Windows-friendly)
# CURSOR_BRIDGE_PROMPT_VIA_STDIN=true

# Optional: use ACP over stdio (agent acp) — avoids Windows argv limits
# CURSOR_BRIDGE_USE_ACP=false
# When CURSOR_API_KEY is set, authenticate is skipped unless you force:
# CURSOR_BRIDGE_ACP_SKIP_AUTHENTICATE=true
# Raw JSON-RPC logging (needs NODE_DEBUG=cursor-api-proxy:acp)
# CURSOR_BRIDGE_ACP_RAW_DEBUG=false

# Optional: Windows CreateProcess cmdline budget for prompt truncation
# CURSOR_BRIDGE_WIN_CMDLINE_MAX=30000
# CURSOR_AGENT_NODE=C:\Program Files\nodejs\node.exe
# CURSOR_AGENT_SCRIPT=C:\path\to\agent\index.js

# Optional: TLS (e.g. Tailscale)
# CURSOR_BRIDGE_TLS_CERT=
# CURSOR_BRIDGE_TLS_KEY=

# Optional: request / traffic logging
# CURSOR_BRIDGE_SESSIONS_LOG=~/.cursor-api-proxy/sessions.log
# CURSOR_BRIDGE_VERBOSE=false

# Isolated temp workspace (default true). Set false only if the CLI should see real paths.
# CURSOR_BRIDGE_CHAT_ONLY_WORKSPACE=true