Getting Started
GitHub Integration
Automatically extract decisions from your pull requests.
Lithium watches your merged pull requests and extracts engineering decisions into your cluster tree automatically.
Requires a Pro plan.
Connect GitHub
Install the GitHub App
In the CLI, go to Settings and select Connect GitHub. A browser window opens to install the Lithium GitHub App on your organization.
Select repositories
Choose which repositories Lithium should watch. You can grant access to all repositories or pick specific ones.
After a PR is merged
Lithium analyzes the PR and may produce:
- New clusters if the PR covers an area not yet in your tree (e.g.
payments.stripe) - New decisions placed into the relevant cluster
- Updated decisions if the PR changes an existing convention
Decisions are versioned and link back to the source PR. They appear in the CLI within a few minutes.
Routine changes like dependency bumps or small bug fixes are skipped.
Example
A PR titled "Switch to httpOnly cookies for refresh tokens" might produce:
| Cluster | Decision |
|---|---|
auth.tokens | Refresh tokens are stored in httpOnly cookies. Server-side rotation on each use. Never expose tokens to client-side JavaScript. |
Manage the connection
- Change repository access: Go to your GitHub organization settings under Installed GitHub Apps
- Reconnect: In the CLI, go to Settings and select Connect GitHub again