# Getting Started with Mojule

Mojule gives engineering leaders real-time adoption intelligence across Claude Code, Desktop, and Web. This guide gets you from zero to dashboard in under 5 minutes.

## Prerequisites

- A Mac (Apple Silicon or Intel) with Claude Code installed
- An admin or owner role in your organization

## Step 1: Create your account

1. Visit [app.mojule.cloud](https://app.mojule.cloud)
2. Click **Get started**
3. Sign in with your work email (SSO supported for enterprise plans)
4. Name your organization when prompted — this is the workspace Mojule tracks adoption for
5. You'll land on your dashboard with a **Set up connector** prompt

## Step 2: Install the connector

1. From the dashboard, click **Set up connector**
2. Click **Generate install command** — this mints a one-time token valid for 15 minutes
3. Copy the command and run it in your terminal:
   ```
   curl -fsSL https://app.mojule.cloud/install.sh | sh -s -- --setup-token mst_...
   ```
4. The installer will:
   - Download the Mojule connector binary to `~/.mojule/bin/`
   - Verify its integrity (SHA-256 checksum)
   - Exchange the setup token for a scoped telemetry-write key
   - Configure Claude Code and Claude Desktop to send usage telemetry to Mojule
5. Follow the printed instructions to add `~/.mojule/bin` to your PATH and source the Mojule env in your shell profile

## Step 3: Verify the installation

Run the built-in health check:

```bash
mojule-connector doctor
```

All checks should pass. The only expected warning is if Claude Desktop is not installed.

## Step 4: See your data

1. Open a new terminal and start a Claude Code session
2. Use Claude normally for a minute or two
3. Return to [app.mojule.cloud/dashboard](https://app.mojule.cloud/dashboard)
4. Your session will appear within 60 seconds

## What Mojule captures

- Session count, duration, and timestamps
- Model used (Sonnet, Opus, Haiku)
- Token counts (input and output)
- Tool names invoked
- Surface (Code, Desktop, Web)

## What Mojule does NOT capture

- Prompts or completions
- File contents or paths
- Code snippets
- Tool arguments or outputs
- Error message bodies

This is enforced at the connector level and again at Mojule's server-side ingest filter.

## Invite your team

Each team member runs the same install command on their own machine. Generate a new token from **Set up connector** for each install. All data flows into your shared org dashboard automatically.

## Uninstall

```bash
mojule-connector uninstall
```

This removes all Mojule configuration from the machine. Claude Code and Desktop continue working normally.

## Support

- Email: [paul@mojule.cloud](mailto:paul@mojule.cloud)
- Dashboard: [app.mojule.cloud](https://app.mojule.cloud)