WE ARE LIVE ON NPM & PYPI|gsoc-contrib v0.5.3

SPARSE. BLOBLESS.

CONTRIBUTE.

contrib-cli is the zero-clone workspace engine between GitHub issues and your IDE. Sub-3.4s workspace creation. 95% bandwidth savings. Instant developer onboarding.

// SECTION: WHAT_WE_ARE_BUILDING
MISSION ARCHITECTURE003

WHAT WE ARE BUILDING

contrib-cli is engineered to bridge open-source issue discovery, instant zero-clone workspaces, and modern IDE workflows into a single seamless CLI.

CORE ENGINE
[01]

ZERO-CLONE WORKSPACE ENGINE

Sub-3.4s workspace initialization leveraging Git blobless clones (--filter=blob:none) and sparse checkouts. Stop downloading multi-gigabyte repo histories to fix a single line of code.

95.4% average bandwidth reduction
91.2% local disk space savings
Automatic branch isolation per issue/PR
Instant workspace status tracking & cleanup
$ contrib start https://github.com/org/repo/issues/101
SMART MATCHING
[02]

AI GSOC & ISSUE RECOMMENDER

AI-powered recommendation engine matching contributor skill sets (languages, domains, experience level) with official GSoC organizations and open contribution opportunities.

Interactive quiz mode (contrib recommend)
Skill filtering (--lang python,js --domain ai)
Good-first-issue discoverability across 100+ orgs
Historical GSoC repo indexing & classification
$ contrib recommend --lang python,javascript --level beginner
NATIVE INTEGRATION
[03]

ANTIGRAVITY IDE & EDITOR BRIDGE

First-class editor launch flags. Open your newly created lightweight workspace instantly in Antigravity IDE (--agy), Neovim, Vim, Helix, Zed, VS Code, or Cursor.

Native --agy / --ide / --antigravity flags out of the box
Terminal editor auto-detection (Neovim, Vim, Helix)
One-command open for active workspaces (contrib open --agy)
Cross-platform support (Windows, macOS, Linux)
$ contrib start https://github.com/org/repo/issues/101 --agy
METADATA ENGINE
[04]

PRE-CLONE ISSUE ANALYZER

Inspect GitHub issue context, linked pull requests, labels, and relevant target repository file paths directly from your terminal before cloning a single file.

GitHub REST & GraphQL API metadata resolution
Target file impact estimation
Linked PR status and discussion inspection
Offline workspace state caching
$ contrib analyze https://github.com/org/repo/issues/101
// SECTION: AI_AGENT_CASE_STUDY
ANTIGRAVITY IDE VERIFIED007
ZERO COLD-START LATENCY FOR AI AGENTS

STRUCTURED AI BRIEFING ENGINE

When you launch a workspace with $ contrib start <url> --agy, contrib-cli deterministically generates a 3-file briefing package inside .contrib/. This eliminates 80% of codebase discovery friction for AI Pair Programmers.

GENERATED BRIEFING PACKAGE (.contrib/)
context.json
METADATA

Machine-readable metadata — repo, issue #, branch, stack, test/build commands, quality tools

ISSUE.md
CONTEXT

Raw issue content, reproduction steps, linked discussions, and target labels

AI_PROMPT.md
SYNTHESIS

Synthesized AI prompt — combines issue body, focus area code paths, CONTRIBUTING.md, PR template, & rules

Skips 80% of AI codebase discovery time
Pre-creates feature branch (contrib/issue-934)
AI AGENT ANALYSIS
// ANTIGRAVITY IDE OBSERVED:

“That's a very well-designed tool. It takes a GitHub issue and produces a structured AI briefing package in .contrib/.”

“The focus_areas extraction pulls specific code references out of the issue body and surfaces them as entry points. That's what let me skip 80% of discovery.”

“Contributing to open source has enormous cold-start cost for AI agents. .contrib eliminates the cold start by doing that translation once per issue, offline, deterministically.”

// LIVE BENCHMARK: JustVugg/colibri50% .GIT SAVINGS
Full Clone .git:17.67 MB
contrib Workspace .git:8.86 MB (50% smaller⚡)
Verified in Antigravity IDEIssue #934 Benchmark
// SECTION: RAW_DATA
004
terminal.sys
_
sparse_tree.visualizerBLOBLESS_CANVAS
inference.metrics
0.0msAvg Latency
00.0KRequests / sec
00.00%Uptime
000Models Deployed
ide_launchers.statusSYNC:0000
Target IDEStatusCLI Flag
ANTIGRAVITY
READY
--agy
VS CODE
READY
--vscode
NEOVIM
READY
--nvim
ZED / HELIX
READY
--zed
CURSOR
READY
--cursor
IDE Integration Compatibility100%
// SECTION: ABOUT_CONTRIB_CLI
005
SYSTEM_DIAGNOSTICS: BENCHMARK.LOGVERIFIED
// Standard Git Clone
Clone Time: 68.4 seconds
Bandwidth: 450 MB downloaded
Disk Space: 1.2 GB stored
// contrib-cli Workspace
Clone Time: 3.4 seconds⚡
Bandwidth: 14 MB downloaded (96% less)
Disk Space: 32 MB stored (97% less)
ENGINE: GIT_SPARSE_CHECKOUTSTATUS: OPERATIONAL
ARCHITECTURE.MDv0.5.3

Architecture built for
zero-clone velocity

contrib-cli solves the friction of open-source contribution. Instead of downloading gigabytes of repository blobs just to fix a single bug or submit a small PR, contrib-cli leverages Git's blobless clones (--filter=blob:none) and sparse checkouts to create isolated developer workspaces in under 5 seconds.

Built for Google Summer of Code (GSoC) participants, open-source maintainers, and developer tooling enthusiasts who want zero-wait contribution environments.

CLI OPERATIONAL UPTIME:0d 00h 00m 00s
AVG_SETUP_TIME3.4s
BANDWIDTH_SAVED95.4%
DISK_SPACE_SAVED91.2%
IDES_SUPPORTED8+
// SECTION: 2_STEP_QUICKSTART
006
🟢 LIVE ON NPM & PYPI REGISTRIES

GET STARTED IN 2 STEPS

Install globally via NPM or PyPI (pip), or run instantly with npx.

STEP [01]DOWNLOAD & INSTALL

1. INSTALL (NPM & PYPI)

`contrib-cli` is published on both NPM and PyPI. Choose your preferred package manager:

$ npm install -g gsoc-contrib
$ pip install gsoc-contrib
Published on NPM Registry (`gsoc-contrib`)
Published on PyPI (`pip install gsoc-contrib`)
Instant zero-install mode via `npx gsoc-contrib init`
NPM PACKAGE ↗PYPI PACKAGE ↗
STEP [02]START WORKSPACE

2. START WORKSPACE

Pass any GitHub issue URL. `contrib` creates a sparse checkout and opens your IDE in 3.4 seconds.

$ contrib start <issue-url>
Shorthand: $ contrib contribute owner/repo#123
Fetches blobless commit tree (--filter=blob:none)
Creates feature branch (contrib/fix-issue)
Launches Antigravity IDE / VS Code instantly
// OTHER HELPER COMMANDS:
`contrib analyze <url>` | `contrib recommend` | `contrib open --antigravity`
View Full CLI Docs ↗