CLI Installation

The Meridian Track CLI (meridian) lets you track time, manage projects and clients, and view entries directly from your terminal. No Python or package manager required.

Prerequisites

An active Meridian Track account with an API key
macOS 13+, Windows 10+, or Linux (Ubuntu 20.04+, Debian 10+)

Installation

macOS / Linux

curl -fsSL https://cli.meridiantrack.com/install.sh | bash

Windows (PowerShell)

irm https://cli.meridiantrack.com/install.ps1 | iex

Windows (CMD)

curl -fsSL https://cli.meridiantrack.com/install.cmd -o install.cmd && install.cmd && del install.cmd

Verify

meridian version

Authentication

1. Create an API Key

Navigate to API Keys in the Meridian Track app and create a new key. See Authentication for details on scopes and best practices.

2. Log In

meridian auth login

You will be prompted to paste your API key. Alternatively, pass it directly:

meridian auth login --api-key mt_live_your_key_here

The CLI stores your API key securely in your system keyring (macOS Keychain, Windows Credential Manager, or Linux Secret Service).

If your workspace has a single member, the CLI auto-detects your user ID. For multi-member workspaces, set it manually:

meridian auth set-user YOUR_USER_ID

3. Verify

meridian auth status

This shows your masked API key, user ID, and API URL.

Configuration

Config File

The CLI stores settings in ~/.meridian/config.json. You can manage it with:

meridian config show         # view all settings
meridian config get api_url  # get a specific key
meridian config set api_url https://api.meridiantrack.com  # set a key

Environment Variables

Environment variables override config file and keyring values:

Variable	Purpose
`MERIDIAN_API_KEY`	API key (overrides keyring)
`MERIDIAN_USER_ID`	User ID (overrides config file)
`MERIDIAN_BASE_URL`	API base URL (default: `https://api.meridiantrack.com`)

Updating

The CLI checks for updates in the background every 4 hours and downloads new versions automatically. Updates are applied the next time you run meridian.

Manual Update

meridian update

Check for Updates

meridian update --check

Disable Auto-Updates

Pin to your current version:

meridian update --pin

Or set the environment variable:

export MERIDIAN_NO_AUTO_UPDATE=1

Re-enable Auto-Updates

meridian update --unpin

Uninstalling

macOS / Linux

rm -rf ~/.local/share/meridian ~/.local/bin/meridian ~/.local/bin/meridian-mcp

Windows (PowerShell)

Remove-Item -Recurse -Force "$env:LOCALAPPDATA\meridian"

Remove Configuration (Optional)

rm -rf ~/.meridian

Next Steps

Command Reference — full list of commands and options
MCP Server — use Meridian Track from Claude Desktop, Cursor, or Claude Code