Skip to content

README.md

Latest commit

 

History

History
114 lines (85 loc) · 4.46 KB

README.md

File metadata and controls

114 lines (85 loc) · 4.46 KB

Gittensory

CI MCP package License Docs

Gittensory is a deterministic control plane for Gittensor OSS contribution work.

It gives contributors and maintainers structured signals before work turns into noisy PRs: official Gittensor context, repo queue health, collision risk, branch preflight, scoreability, maintainer packet context, and public-safe PR guidance.

It is not a Gittensor explorer, public leaderboard, reward-farming bot, or autonomous PR agent.

Product Map

Surface What it is Start here
MCP package Local stdio tools for Codex, Claude Desktop, Cursor, and other MCP clients. MCP client setup
Web app Operator UI, docs, API browser, roadmap, and workflow views. gittensory.aethereal.dev
Worker API Protected Cloudflare Worker API with OpenAPI metadata. OpenAPI JSON
GitHub App Quiet maintainer automation for installed repos. GitHub App docs

Install MCP

npm install -g @jsonbored/gittensory-mcp@latest
gittensory-mcp login
gittensory-mcp doctor
gittensory-mcp --stdio

Print editor/client snippets:

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

Run base-agent commands:

gittensory-mcp agent plan --login jsonbored --json
gittensory-mcp agent packet --login jsonbored --json
gittensory-mcp agent status <run-id> --json

What It Helps With

For contributors For maintainers
Pick cleaner repos and issues before opening work. See private reviewability and queue context without public noise.
Preflight local branches without uploading source contents. Keep GitHub App output public-safe and low-volume.
Understand score blockers, collision risk, and PR cleanup order. Detect lane, label, config, sync, and maintainer-friction problems.
Draft better public PR packets from deterministic signals. Separate useful Gittensor work from review-load churn.

Privacy Boundary

Gittensory keeps sensitive context private by default.

  • MCP local branch analysis sends metadata, not source contents.
  • Public GitHub comments never include wallet, hotkey, reward estimate, private ranking, raw trust score, or reviewability context.
  • Optional AI summaries receive compact deterministic signal bundles, not raw source code.
  • Maintainer packets and scoring context are protected API/MCP surfaces.

See Privacy and security for the full boundary.

Local Development

npm install
npm run cf-typegen
npm run db:migrate:local
npm run dev

Frontend:

npm run ui:dev
npm run ui:build

Normal validation:

npm run test:ci

Release-only validation:

npm run test:release
npm run test:release:mcp

Links

Need Link
Docs gittensory.aethereal.dev/docs
Quickstart docs/quickstart
Branch analysis docs/branch-analysis
Scoreability docs/scoreability
Troubleshooting docs/troubleshooting
API openapi.json
npm @jsonbored/gittensory-mcp
Contributing CONTRIBUTING.md
Security SECURITY.md
Support SUPPORT.md

Normal feature/fix PRs do not edit changelogs. Changelogs are release-prep artifacts.