Getting Started

Installation

From install to your first AI session in under a minute.

Install

npm i -g @lithium-ai/cli
pnpm add -g @lithium-ai/cli
yarn global add @lithium-ai/cli

Sign in and create an organization

lithium

Signs you in via GitHub. You'll be prompted to create an organization for your team.

Create a decision

In the CLI, go to Decisions and add a cluster and a decision.

Clusters group related decisions. Decisions are the rules your AI tools follow.

auth.tokens → "Refresh tokens are single-use. Store in httpOnly cookies."

Connect an AI tool

Go to MCP Setup in the CLI. Copy your token, then configure your tool:

claude mcp add --transport http lithium https://getlithium.ai/api/mcp \
  -H "Authorization: Bearer YOUR_TOKEN"

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "lithium": {
      "type": "http",
      "url": "https://getlithium.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Add to .windsurf/mcp.json:

{
  "mcpServers": {
    "lithium": {
      "type": "http",
      "url": "https://getlithium.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Configure automatic usage

Set up hooks or rules so your AI tool calls Lithium on every task. See Configuration for setup instructions per tool.

Once configured, your AI tool will call Lithium automatically:

lithium · list_clusters (MCP)
lithium · get_context("auth.tokens") (MCP)