> ## Documentation Index
> Fetch the complete documentation index at: https://meridiona-mintlify-2ae70a19.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to Meridian — Ambient Dev Automation Docs

> Everything you need to install, configure, and run Meridian — the local-first daemon that turns screenpipe recordings into automatic PM ticket updates.

Meridian is a local-first ambient automation daemon that reads your screen activity, structures it into labelled work sessions, and automatically updates your Jira, GitHub, or Linear tickets — with zero manual input and no data leaving your machine. This documentation covers everything from installation to advanced configuration.

<CardGroup cols={2}>
  <Card title="Introduction" icon="book-open" href="/introduction">
    Learn what Meridian does, how it works, and what you need before you install.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Install from npm and have Meridian running and drafting worklogs in under 10 minutes.
  </Card>

  <Card title="MCP Server Setup" icon="plug" href="/guides/mcp-setup">
    Connect Meridian's session data to Claude, Cursor, or any MCP-compatible AI tool.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/reference/cli">
    Every `meridian` command — start, stop, logs, doctor, config, and more.
  </Card>
</CardGroup>

## Get up and running in three steps

<Steps>
  <Step title="Install">
    Install the Meridian CLI from npm and run the one-time setup. The bundle ships a prebuilt binary — no clone, no compiler — and `meridian setup` installs any missing prerequisites (Homebrew packages, Python, screenpipe, ffmpeg) and registers the background services.

    ```bash theme={null}
    npm install -g @meridiona/meridian
    meridian setup
    ```
  </Step>

  <Step title="Configure">
    Open the config in your `$EDITOR` and add credentials for the tracker you use (Jira, Linear, or GitHub):

    ```bash theme={null}
    meridian config edit
    ```
  </Step>

  <Step title="Start">
    The setup command registers launchd agents that start automatically. Confirm everything is up and open the dashboard:

    ```bash theme={null}
    meridian status
    # Dashboard → http://localhost:3939
    ```
  </Step>
</Steps>

<Note>
  **All your data stays on your machine.** Meridian never phones home, sends telemetry, or forwards screen recordings to any remote server. Your activity database lives at `~/.meridian/meridian.db` and is yours alone.
</Note>