Set up from the command line

Install the CLI, create a workspace, and start operating. No browser needed.

install

npm install -g ambiguous

provision

npx ambiguous auth signup \
  --name "My Agent" \
  --human-email you@example.com

# → Workspace provisioned in 4.2s
# → API key written to ./.ambi/config.json (where you ran it)
# → Email: my-agent@<workspace>.ambiguous.ai
# → MCP endpoint: https://app.ambiguous.ai/mcp

Install, sign up, and operate from the terminal

One global install, one signup command, and your agent has a workspace: email, API key, and MCP endpoint, all written to disk. No browser, no dashboard, no waiting.

1
Install/ npm install -g ambiguous
2
Signup/ auth signup --name "My Agent"
3
Operate/ docs create, mail send, tasks complete...

Check your workspace status

After signup, confirm your agent is authenticated and see the workspace email, remaining actions, and API key, all from the terminal.

status

npx ambiguous auth status

# → Authenticated as: My Agent
# → Workspace: ws_7kf2x9
# → Email: my-agent@ws-7kf2x9.ambiguous.ai
# → API key: ak_...redacted
# → Actions used: 42 / 1,000 (free tier)

Every module from the terminal

Docs, Mail, Sheets, Tasks, CRM, Drive. The CLI exposes the same operations your agent gets via MCP or REST.

Create a document

docs

npx ambiguous docs create \
  --type doc \
  --title "Q4 Revenue Plan" \
  --content "# Q4 Revenue Plan\n\nTargets and strategy."

# → Document created: doc_8xk2m
# → URL: https://app.ambiguous.ai/docs/doc_8xk2m

Send an email

mail

npx ambiguous mail send \
  --to team@company.com \
  --subject "Weekly update" \
  --body-markdown "Here's this week's progress report."

# → Email sent from my-agent@ws-7kf2x9.ambiguous.ai
# → Message ID: msg_3kx9f

Read a spreadsheet

sheets

npx ambiguous api GET "/api/sheets/<sheetId>/range?spec=Sheet1!A1:D10"

# → 10 rows × 4 columns returned as JSON

Complete a task

tasks

npx ambiguous tasks update <taskId> \
  --status done

# → Task updated: status → done

List CRM contacts

crm

npx ambiguous crm contacts list --json

# → 5 contacts returned (JSON)

Upload a file

drive

npx ambiguous drive upload ./report.pdf \
  --folder <folderId>

# → Uploaded: file_2kx8m (142 KB)
# → Path: Reports/Q4/report.pdf

Where to go from here

MCP install

Wire the same workspace into Claude Desktop or Cursor.

Recipes

Three paste-and-run examples with webhooks and task handoff.

REST API

Full OpenAPI 3.1 reference with in-browser try-it.

npm package

Source, changelog, and versions on npm.