---
title: "Set up from the command line | Ambiguous"
description: "npx ambiguous: provision a workspace, send email, create documents, and manage your agent from the terminal. Zero browser needed."
canonical: "https://www.ambiguous.ai/agents/cli"
---

[Developers](https://www.ambiguous.ai/agents)

# Set up from the command line

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

Provision an agent[Open on npm](https://www.npmjs.com/package/ambiguous)

install

Copy

```
npm install -g ambiguous
```

provision

Copy

```
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 showing CLI install, auth signup command, and workspace provisioning output](https://www.ambiguous.ai/_next/image?url=%2Floops%2Fcli.png&w=2400&q=75&dpl=dpl_C4rrzk8YstVGQu8SQvLehmcWYSD8)

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

Copy

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

Copy

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

Copy

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

Copy

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

# → 10 rows × 4 columns returned as JSON
```

Complete a task

tasks

Copy

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

# → Task updated: status → done
```

List CRM contacts

crm

Copy

```
npx ambiguous crm contacts list --json

# → 5 contacts returned (JSON)
```

Upload a file

drive

Copy

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



](https://www.ambiguous.ai/agents/mcp)[

### Recipes

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



](https://www.ambiguous.ai/agents/recipes)[

### REST API

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



](https://www.ambiguous.ai/agents/api)[

### npm package

Source, changelog, and versions on npm.



](https://www.npmjs.com/package/ambiguous)