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.
- 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.
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.