# Meridian

## Docs

- [Activity Categories: How Meridian Classifies Your Work](https://meridiona-mintlify-e56c5cf3.mintlify.app/concepts/categories.md): The ten fixed activity categories Meridian uses to classify every session, how confidence scores work, and where categories appear in the dashboard.
- [How Meridian Works: From Screen Frames to Ticket Updates](https://meridiona-mintlify-e56c5cf3.mintlify.app/concepts/how-it-works.md): Understand the three-layer pipeline that turns raw screenpipe recordings into categorized sessions and automatic project management updates.
- [App Sessions: The Core Unit of Meridian Activity Data](https://meridiona-mintlify-e56c5cf3.mintlify.app/concepts/sessions.md): Learn what a session is, how Meridian detects session boundaries, and what every field in the app_sessions table means — with direct query examples.
- [Task Classification: Linking Sessions to Jira Tickets](https://meridiona-mintlify-e56c5cf3.mintlify.app/concepts/task-classification.md): Learn how Meridian uses on-device AI to match every work session to a specific Jira, GitHub, or Linear ticket — with no manual tagging required.
- [Configure Meridian: All Environment Variables Explained](https://meridiona-mintlify-e56c5cf3.mintlify.app/configuration.md): Learn where Meridian's config files live, how to edit them, and what every environment variable does — from polling intervals to PM credentials.
- [Monitor Your Activity in the Meridian Local Dashboard](https://meridiona-mintlify-e56c5cf3.mintlify.app/guides/dashboard.md): Explore the local web dashboard that shows your active session, focus time, category breakdown, and full day timeline, updated in real time as you work.
- [Connect Meridian to GitHub Issues or Linear Issues](https://meridiona-mintlify-e56c5cf3.mintlify.app/guides/github-linear.md): Pull open GitHub or Linear issues into Meridian so coding sessions are automatically classified against the right tickets, with no manual tracking needed.
- [Connect Meridian to Jira Cloud for Automatic Tracking](https://meridiona-mintlify-e56c5cf3.mintlify.app/guides/jira.md): Link your Jira Cloud workspace to Meridian so sessions are classified against your open tickets and time is tracked without manual input.
- [Expose Your Meridian Session Data to AI Tools via MCP](https://meridiona-mintlify-e56c5cf3.mintlify.app/guides/mcp-setup.md): Connect Claude, Cursor, or any MCP-compatible AI tool to your local Meridian session database so you can ask natural-language questions about your workday.
- [Query Meridian's SQLite Database for Custom Activity Reports](https://meridiona-mintlify-e56c5cf3.mintlify.app/guides/querying-data.md): Directly query Meridian's local SQLite database to pull custom reports, export data, or explore your session history beyond what the dashboard provides.
- [Review and Approve Worklogs Before They Post to Jira](https://meridiona-mintlify-e56c5cf3.mintlify.app/guides/worklogs.md): Use the Worklogs view in the Meridian dashboard to review, edit, and approve drafted worklogs — the only path that posts time to your tracker.
- [Meridian: Stop Updating Tickets and Start Shipping](https://meridiona-mintlify-e56c5cf3.mintlify.app/introduction.md): Understand what Meridian does, the problem it solves, its core capabilities, and what you need on your machine before you install.
- [Quickstart: From Zero to a Running Meridian Install](https://meridiona-mintlify-e56c5cf3.mintlify.app/quickstart.md): Clone Meridian, grant screenpipe permissions, enter your credentials, and get automatic ticket updates flowing — step by step, from zero to running.
- [Meridian CLI Reference: Commands, Flags, and Usage](https://meridiona-mintlify-e56c5cf3.mintlify.app/reference/cli.md): Complete reference for every meridian CLI command and install.sh flag, including start, stop, logs, doctor, config, permissions, and uninstall.
- [Meridian Environment Variables and Configuration Reference](https://meridiona-mintlify-e56c5cf3.mintlify.app/reference/environment-variables.md): All environment variables Meridian reads from ~/.meridian/.env — core daemon, classification, Jira, GitHub, Linear, and MCP server settings.
- [Meridian MCP Tools Reference: All 12 Tools and Parameters](https://meridiona-mintlify-e56c5cf3.mintlify.app/reference/mcp-tools.md): All twelve MCP tools exposed by the Meridian MCP server — parameters, descriptions, and example questions each tool is designed to answer.
- [Meridian Session Schema: Tables, Columns and JSON Formats](https://meridiona-mintlify-e56c5cf3.mintlify.app/reference/session-schema.md): Full schema for meridian.db — app_sessions column types, JSON field formats, related tables, and example SQLite queries you can run directly.
- [Meridian Troubleshooting: Diagnose and Fix Common Issues](https://meridiona-mintlify-e56c5cf3.mintlify.app/reference/troubleshooting.md): Step-by-step fixes for installation failures, daemon crashes, Jira and GitHub auth errors, MCP server issues, and macOS permission problems.