Gittensory has two auth surfaces:
Run:
gittensory-mcp loginThe CLI starts GitHub Device Flow, asks you to approve the code on GitHub, then exchanges the GitHub token server-side for a short-lived Gittensory session token.
Gittensory stores:
Gittensory does not store user PATs.
For local automation, pass a GitHub token only long enough to mint a Gittensory session:
gittensory-mcp login --github-token "$(gh auth token)"The token is exchanged immediately. The MCP wrapper stores the Gittensory session token, not the GitHub token.
gittensory-mcp whoami
-gittensory-mcp status
-gittensory-mcp doctorgittensory-mcp logoutLogout revokes the remote session when possible and removes the local config file.
Static bearer tokens remain only for private backend operations, internal jobs, and temporary beta bootstrap. Normal MCP users should use GitHub OAuth.
`,21)])])}const u=i(h,[["render",n]]);export{c as __pageData,u as default}; diff --git a/docs/assets/guide_auth.md.DNA7JhY7.lean.js b/docs/assets/guide_auth.md.DNA7JhY7.lean.js deleted file mode 100644 index c1c621e628..0000000000 --- a/docs/assets/guide_auth.md.DNA7JhY7.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{c as i,S as t,j as a,m as e}from"./chunks/framework.BXgR76oC.js";const c=JSON.parse('{"title":"Auth","description":"","frontmatter":{},"headers":[],"relativePath":"guide/auth.md","filePath":"guide/auth.md","lastUpdated":1779780644000}'),h={name:"guide/auth.md"};function n(o,s,l,r,p,k){return t(),a("div",null,[...s[0]||(s[0]=[e("",21)])])}const u=i(h,[["render",n]]);export{c as __pageData,u as default}; diff --git a/docs/assets/guide_github-app-setup.md.ZPvLDsvt.js b/docs/assets/guide_github-app-setup.md.ZPvLDsvt.js deleted file mode 100644 index 83f8a94fd1..0000000000 --- a/docs/assets/guide_github-app-setup.md.ZPvLDsvt.js +++ /dev/null @@ -1,3 +0,0 @@ -import{c as t,S as i,j as s,m as a}from"./chunks/framework.BXgR76oC.js";const c=JSON.parse('{"title":"GitHub App Setup","description":"","frontmatter":{},"headers":[],"relativePath":"guide/github-app-setup.md","filePath":"guide/github-app-setup.md","lastUpdated":1779781690000}'),l={name:"guide/github-app-setup.md"};function r(d,e,n,h,o,p){return i(),s("div",null,[...e[0]||(e[0]=[a(`The GitHub App is the maintainer/install surface. GitHub OAuth is the MCP user-auth surface.
Use these values:
| Field | Value |
|---|---|
| Homepage URL | https://gittensory.aethereal.dev |
| Webhook URL | \${GITTENSORY_API_URL}/v1/github/webhook |
| Webhook active | enabled |
| SSL verification | enabled |
| Device Flow | enabled |
GITTENSORY_API_URL is the private API origin for the deployed backend. Do not use the GitHub Pages docs domain for webhooks; Pages only serves static docs.
Use a generated webhook secret and set the same value in Cloudflare as GITHUB_WEBHOOK_SECRET.
| Permission | Access | Why |
|---|---|---|
| Metadata | Read | Required for repository identity and repository events. |
| Checks | Write | Required to create and update the Gittensory check run. |
| Pull requests | Read | Required for PR metadata, reviewability, and webhook events. |
| Issues | Read | Required for issue linkage, issue-discovery context, and duplicate signals. |
Optional:
| Permission | Access | Why |
|---|---|---|
| Issues | Write | Only needed if public-safe sticky PR comments are enabled. |
| Contents | Read | Only needed if a future feature reads repository files directly through the App. |
Subscribe to:
If GitHub shows Installation target, select it. Some installation-related events are not always shown as normal selectable event rows; Gittensory should not block health on event names that are hidden in the app UI.
curl -X POST "$GITTENSORY_API_URL/v1/internal/jobs/refresh-installation-health/run" \\
- -H "Authorization: Bearer $INTERNAL_JOB_TOKEN"curl "$GITTENSORY_API_URL/v1/readiness" \\
- -H "Authorization: Bearer $GITTENSORY_API_TOKEN"Healthy app installation state should remove the readiness warning about GitHub App installations needing attention.
Before Marketplace submission, add:
Do not submit until the privacy, support, terms, install diagnostics, and public setup flow are complete.
`,25)])])}const k=t(l,[["render",r]]);export{c as __pageData,k as default}; diff --git a/docs/assets/guide_github-app-setup.md.ZPvLDsvt.lean.js b/docs/assets/guide_github-app-setup.md.ZPvLDsvt.lean.js deleted file mode 100644 index b93aaf36b6..0000000000 --- a/docs/assets/guide_github-app-setup.md.ZPvLDsvt.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{c as t,S as i,j as s,m as a}from"./chunks/framework.BXgR76oC.js";const c=JSON.parse('{"title":"GitHub App Setup","description":"","frontmatter":{},"headers":[],"relativePath":"guide/github-app-setup.md","filePath":"guide/github-app-setup.md","lastUpdated":1779781690000}'),l={name:"guide/github-app-setup.md"};function r(d,e,n,h,o,p){return i(),s("div",null,[...e[0]||(e[0]=[a("",25)])])}const k=t(l,[["render",r]]);export{c as __pageData,k as default}; diff --git a/docs/assets/guide_install.md.ByQAA8QU.js b/docs/assets/guide_install.md.ByQAA8QU.js deleted file mode 100644 index 8509126a98..0000000000 --- a/docs/assets/guide_install.md.ByQAA8QU.js +++ /dev/null @@ -1,11 +0,0 @@ -import{c as i,S as a,j as t,m as e}from"./chunks/framework.BXgR76oC.js";const c=JSON.parse('{"title":"Install","description":"","frontmatter":{},"headers":[],"relativePath":"guide/install.md","filePath":"guide/install.md","lastUpdated":1779781690000}'),l={name:"guide/install.md"};function n(h,s,p,r,k,o){return a(),t("div",null,[...s[0]||(s[0]=[e(`Gittensory has two install paths: public npm for normal use, and local checkout for development.
Use this for Codex, Claude Desktop, Cursor, or any other stdio MCP client:
npm install -g @jsonbored/gittensory-mcp
-gittensory-mcp login
-gittensory-mcp status
-gittensory-mcp --stdioThe login command uses GitHub Device Flow and stores a short-lived Gittensory session token in your local config directory.
Use this when developing Gittensory itself:
git clone https://github.com/JSONbored/gittensory.git
-cd gittensory
-npm install
-npm link --workspace @jsonbored/gittensory-mcp
-gittensory-mcp login
-gittensory-mcp --stdioRun:
gittensory-mcp doctor
-gittensory-mcp whoami
-gittensory-mcp analyze-branch --login YOUR_GITHUB_LOGIN --jsondoctor checks API health, auth state, source-upload defaults, local git metadata, and whether the binary is likely visible to MCP clients.
Gittensory MCP v1 sends structured metadata only:
It does not upload source contents. GITTENSORY_UPLOAD_SOURCE=true is rejected.
Gittensory is meant to make Gittensor-driven contribution flow less noisy.
The GitHub App creates the detailed maintainer surface:
The check run is the canonical detailed report. Public comments are opt-in and sanitized.
Gittensory maps PRs to maintainer-friendly actions:
review_nowneeds_authorlikely_duplicateclose_or_redirectwatchmaintainer_laneThe point is not to shame contributors. The point is to identify the lowest-friction next step.
Public comments stay off by default.
When enabled, comments can include:
Comments must not include raw trust scores, wallet data, hotkeys, public reward estimates, or public score optimization language.
Repo owners can use Gittensory to inspect:
The MCP package is the contributor-facing surface for coding agents. It runs locally over stdio and calls the private Gittensory API with your Gittensory session token.
Print a config snippet:
gittensory-mcp init-client --print codex
-gittensory-mcp init-client --print claude
-gittensory-mcp init-client --print cursorThese commands do not edit your files. Use an absolute command path if your client does not inherit your shell PATH.
[mcp_servers.gittensory]
-command = "gittensory-mcp"
-args = ["--stdio"]{
- "mcpServers": {
- "gittensory": {
- "command": "gittensory-mcp",
- "args": ["--stdio"]
- }
- }
-}{
- "mcpServers": {
- "gittensory": {
- "command": "gittensory-mcp",
- "args": ["--stdio"]
- }
- }
-}The local wrapper exposes repo context, contributor decision packs, local branch preflight, score blockers, PR packets, variant comparison, and registry change tools.
Useful tools:
gittensory_local_statusgittensory_get_decision_packgittensory_explain_repo_decisiongittensory_preflight_current_branchgittensory_preview_current_branch_scoregittensory_rank_local_next_actionsgittensory_explain_local_blockersgittensory_prepare_pr_packetGittensory helps miners decide what to do next with evidence instead of guesswork.
Run from a Git repo:
gittensory-mcp analyze-branch --login YOUR_GITHUB_LOGIN --jsonThe response includes:
When the current score is blocked by temporary account/queue state, pass the assumptions explicitly:
gittensory-mcp analyze-branch --login YOUR_GITHUB_LOGIN \\
- --pending-merged-prs 3 \\
- --expected-open-prs 0 \\
- --projected-credibility 0.8 \\
- --scenario-note "approved PRs expected to merge" \\
- --jsonGittensory labels that as a user-supplied scenario. It shows the current effective score, the underlying potential score, and what changes if the open-PR and credibility gates clear.
gittensory-mcp preflight --login YOUR_GITHUB_LOGIN --jsonUse this before opening a PR. It is especially useful when you need to know whether a branch is missing tests, missing a linked issue, colliding with active work, or likely to increase maintainer burden.
Gittensory does not promise payouts. It explains scoreability and risk:
That makes recommendations actionable: land or withdraw blocked work, avoid direct PRs in issue-discovery-only repos, improve validation evidence, or pick a repo where your history and the lane actually fit.
`,19)])])}const g=s(n,[["render",t]]);export{c as __pageData,g as default}; diff --git a/docs/assets/guide_miners.md.BeaGERAQ.lean.js b/docs/assets/guide_miners.md.BeaGERAQ.lean.js deleted file mode 100644 index 745cd93753..0000000000 --- a/docs/assets/guide_miners.md.BeaGERAQ.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{c as s,S as e,j as a,m as l}from"./chunks/framework.BXgR76oC.js";const c=JSON.parse('{"title":"For Miners","description":"","frontmatter":{},"headers":[],"relativePath":"guide/miners.md","filePath":"guide/miners.md","lastUpdated":1779785713000}'),n={name:"guide/miners.md"};function t(r,i,h,p,o,k){return e(),a("div",null,[...i[0]||(i[0]=[l("",19)])])}const g=s(n,[["render",t]]);export{c as __pageData,g as default}; diff --git a/docs/assets/index.md.BKalGx3J.js b/docs/assets/index.md.BKalGx3J.js deleted file mode 100644 index 8341947c92..0000000000 --- a/docs/assets/index.md.BKalGx3J.js +++ /dev/null @@ -1 +0,0 @@ -import{c as t,S as i,j as a,m as s}from"./chunks/framework.BXgR76oC.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{"layout":"home","hero":{"name":"Gittensory","text":"Private repo intelligence for Gittensor work.","tagline":"For Gittensor miners, maintainers, and agents: MCP preflight, scoreability projections, and GitHub App review packets. Still not a Gittensor frontend.","image":{"src":"/logo.svg","alt":"Gittensory signal mark"},"actions":[{"theme":"brand","text":"Install MCP","link":"/guide/install"},{"theme":"alt","text":"GitHub App Setup","link":"/guide/github-app-setup"}]},"features":[{"title":"Scoreability","details":"Current estimate, ungated potential, and near-term what-if scenarios."},{"title":"Queue Pressure","details":"Open PR gates, stale branches, duplicate risk, and cleanup-first actions."},{"title":"Role Context","details":"Contributor lane, maintainer lane, owner history, and repo-specific evidence."},{"title":"Reviewability","details":"Private maintainer packets plus public-safe PR guidance."},{"title":"Registry Signals","details":"Repo lanes, label multipliers, issue discovery, bounties, and config drift."},{"title":"MCP Native","details":"Codex, Claude, Cursor, and agents get structured JSON without code upload."}]},"headers":[],"relativePath":"index.md","filePath":"index.md","lastUpdated":1779793775000}'),n={name:"index.md"};function r(o,e,l,d,c,p){return i(),a("div",null,[...e[0]||(e[0]=[s('Gittensory is the private signal layer behind better contributions: official miner context, registry lanes, queue pressure, scoreability projections, maintainer friction, and public-safe PR packets.