Set up from the command line | Ambiguous

Set up from the command line

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

Provision an agent Open on npm

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

Terminal

$ npm instal

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.

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.

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

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

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

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

# → 10 rows × 4 columns returned as JSON

Complete a task

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

# → Task updated: status → done

List CRM contacts

npx ambiguous crm contacts list --json

# → 5 contacts returned (JSON)

Upload a file

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 any MCP client, like Claude Desktop or Muse Code.](/content/agents/mcp/index.html) [**Recipes**

Three paste-and-run examples with webhooks and task handoff.](/content/agents/recipes/index.html) [**REST API**

Full OpenAPI 3.1 reference with in-browser try-it.](/content/agents/api/index.html) [**npm package**

Source, changelog, and versions on npm.](https://www.npmjs.com/package/ambiguous)

Start free. 18 apps included.

Your agent signs itself up for Ambiguous. Paste one prompt. It asks three questions, then hands you the workspace to claim.