Get started

Quickstart

Install the MCP, sign in, and run your first analysis. About two minutes.

1. Install

The MCP is published as @jsonbored/gittensory-mcp. You can run it with npx, or install it globally.

# one-off
npx -y @jsonbored/gittensory-mcp@latest --help

# install
npm i -g @jsonbored/gittensory-mcp@latest

2. Sign in (GitHub Device Flow)

Gittensory never asks for a Personal Access Token. The CLI walks you through GitHub's Device Flow and exchanges the result for a Gittensory session token.

gittensory-mcp login
gittensory-mcp whoami
gittensory-mcp status

Session tokens are Gittensory tokens backed by GitHub identity, not your GitHub PATs. You can log out anytime with gittensory-mcp logout.

3. Run your first analysis

Analyze the current branch with metadata only. No source ever leaves your machine.

gittensory-mcp doctor
gittensory-mcp analyze-branch --login your-login --json
gittensory-mcp preflight --login your-login --json

4. Wire it into your coding agent

Print a config snippet for your editor of choice and paste it in. See MCP client setup for the details. For the full miner path (plan → preflight → packet) and other roles, see Beta onboarding.

gittensory-mcp init-client --print codex
gittensory-mcp init-client --print claude
gittensory-mcp init-client --print cursor

← PreviousBeta onboarding Next →MCP client setup