> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossdesk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Set up MossDesk CLI and create your first CRM records in under 2 minutes.

## Install the CLI

<CodeGroup>
  ```bash npm theme={null}
  npm install -g @mossdesk/cli
  ```

  ```bash pnpm theme={null}
  pnpm add -g @mossdesk/cli
  ```

  ```bash yarn theme={null}
  yarn global add @mossdesk/cli
  ```
</CodeGroup>

Verify the installation:

```bash theme={null}
moss --version
```

## Authenticate

Log in with your API key. You can create one from the [Dashboard](https://app.mossdesk.com) under **Settings > API Keys**.

```bash theme={null}
moss auth login --key moss_k_your_api_key_here
```

Confirm you're authenticated:

```bash theme={null}
moss auth whoami
```

## Create your first records

### Add a contact

```bash theme={null}
moss contact create \
  --name "Jane Smith" \
  --email "jane@acme.com" \
  --phone "+1-555-0100" \
  --title "CTO"
```

### Add a deal

```bash theme={null}
moss deal create \
  --title "Acme Corp - Enterprise" \
  --value 25000 \
  --stage lead \
  --contact-id <contact-id>
```

### Schedule a follow-up

```bash theme={null}
moss followup create \
  --title "Send proposal to Jane" \
  --due-date 2026-02-15 \
  --contact-id <contact-id> \
  --priority high
```

### Check your pipeline

```bash theme={null}
moss pipeline show
```

## Use JSON output

Every command supports `--json` for structured output, perfect for scripting and AI agents:

```bash theme={null}
moss contact list --json | jq '.data[].name'
```

## Next steps

<CardGroup cols={2}>
  <Card title="Core Concepts" icon="book" href="/guides/concepts">
    Learn about workspaces, deal stages, and the MossDesk data model.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/cli/overview">
    Full command reference with all flags and options.
  </Card>

  <Card title="API Reference" icon="code" href="/api/overview">
    Integrate MossDesk into your applications.
  </Card>

  <Card title="AI Agent Guide" icon="robot" href="/guides/ai-agents">
    Set up MossDesk for autonomous CRM management.
  </Card>
</CardGroup>