# 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

```bash
npm install -g ambiguous
```

## Provision

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

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

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

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

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

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

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

Complete a task

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

# → Task updated: status → done
```

List CRM contacts

```bash
npx ambiguous crm contacts list --json

# → 5 contacts returned (JSON)
```

Upload a file

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