Lithium AI

Team decisions, injected straight into your LLM via MCP.

What is this?

Lithium captures what your team has decided and serves it to Claude, Cursor, or any MCP-compatible client. Your AI stops guessing and starts following your actual conventions.

Install

npm i -g @lithium-ai/cli

Quick Start

lithium

Login with GitHub. Create an org. Add decisions.

┌ Lithium AI
│
├ Organizations
│ └ my-team
│
├ Decisions
│ ├ architecture
│ │ └ "Use Drizzle ORM with fp-ts TaskEither"  v3
│ ├ architecture.database
│ │ └ "PostgreSQL with LTREE for hierarchies"   v1
│ └ infra
│   └ "Deploy via Vercel, DB on Supabase"       v2
│
└ MCP Setup

MCP Setup

Two tools are exposed: list_clusters and get_context.

Claude Code

claude mcp add --transport http lithium https://getlithium.ai/api/mcp \
  -H "Authorization: Bearer <your-token>"

Cursor

Settings > MCP:

{
  "lithium": {
    "transport": "http",
    "url": "https://getlithium.ai/api/mcp",
    "headers": {
      "Authorization": "Bearer <your-token>"
    }
  }
}

Any MCP Client

Point it at https://getlithium.ai/api/mcp with your bearer token. Grab your token from MCP Setup in the CLI.

Autopilot (Claude Code)

Add to your project's .claude/settings.json so Claude checks your team's decisions before every response:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Check lithium.list_clusters and get_context for relevant team decisions before proceeding.'"
          }
        ]
      }
    ]
  }
}

Concepts

| Concept | What it is | | ----------------- | --------------------------------------------------------------------------------- | | Clusters | Nested knowledge domains: architecture, architecture.database, infra.deploy | | Decisions | Versioned records inside clusters. Browse history with arrow keys | | Organizations | Scopes everything to your team. Invite teammates, they see everything immediately |

Keyboard Shortcuts

| Key | Action | | ------- | --------------- | | c | Create cluster | | d | Create decision | | e | Edit decision | | -> | Older version | | <- | Newer version | | Enter | Select | | Esc | Back |

Team Onboarding

# 1. Invite from the CLI
#    Organizations > your org > Invite

# 2. Teammate installs
npm i -g @lithium-ai/cli
lithium

# 3. Accept invite
#    Organizations > Invites > Accept
# Done.

Requirements

• Node.js 18+
• GitHub account

getlithium.ai