git-into-gsoc

AI-native toolkit for aspiring Google Summer of Code contributors — starting with GSoC 2027.

One-shot installable Agent Skill + MCP server + CLI that works with Claude Code, Codex, Cursor, Gemini CLI, and other assistants that load portable skills / MCP.

It guides the full journey: understand the program → discover orgs → evaluate repos → find available beginner issues → make high-quality contributions → engage communities → prepare proposals → track progress.

Never fabricates opportunities. Never encourages spammy AI-generated contributions. Evidence from GitHub and GSoC archives, grounded in official GSoC guidance.

Why this exists

Generic “good first issue” finders and unconstrained coding agents often push beginners toward:

• abandoned repos and already-claimed issues

• typo-farm PRs mentors hate

• AI-written proposals orgs auto-reject

git-into-gsoc is opinionated the other way: mentor-trusted contributors, official sources, availability checks, and a journey skill that refuses spam workflows.

Related MCP server: OpenCollab MCP

Features

Quick start

git clone https://github.com/anandkaranubc/git-into-gsoc.git
cd git-into-gsoc
./install.sh
export GITHUB_TOKEN=ghp_...   # recommended for GitHub API rate limits

git-into-gsoc doctor
git-into-gsoc program --year 2027
git-into-gsoc recommend --github YOUR_USER --tech python --interests science

Then in Cursor / Claude Code / Codex / Gemini CLI:

Use the git-into-gsoc skill. I want to prepare for GSoC 2027; I know Python and care about scientific computing.

See skills/git-into-gsoc/references/install.md for MCP JSON snippets.

CLI cheatsheet

git-into-gsoc program --year 2027
git-into-gsoc orgs --tech python --topics science --year 2026
git-into-gsoc org "SymPy"
git-into-gsoc repo sympy/sympy
git-into-gsoc issues --language python --org sympy
git-into-gsoc issue sympy/sympy 123
git-into-gsoc recommend --github alice --tech python
git-into-gsoc proposal
git-into-gsoc progress summary
git-into-gsoc journey
git-into-gsoc mcp          # stdio MCP server

JSON output: add --output json to most commands.

MCP tools

Architecture

skills/git-into-gsoc/     # portable Agent Skill (progressive disclosure)
src/git_into_gsoc/
  cli.py                  # Typer CLI
  mcp_server.py           # FastMCP stdio server
  service.py              # shared facade
  github/                 # GitHub REST intelligence
  gsoc/                   # org archive + timeline
  scoring/                # org / repo / issue scores
  progress/               # local progress.json
  guidance.py             # official sources + ethics

Data sources

• Official GSoC site & Google developer docs (cited, not scraped for auth-gated content)

• GSoC Organizations API (community archive of public GSoC pages)

• GitHub REST API (optional GITHUB_TOKEN)

GSoC 2027: org lists and dates may be unpublished. The toolkit defaults research to the latest archived year (2026) and labels 2027 timeline entries as estimates until Google publishes them.

Differentiation

Compared with generic OSS issue MCP servers or multi-skill OSS packs:

1. GSoC-native journey (proposal, bonding, org continuity) — not only “find an issue”

2. Archive-aware org matching with technologies/topics/years

3. Skill + MCP + CLI one-shot install across assistants

4. Explicit anti-spam / anti-fabrication product stance aligned with official AI and spam guidance

Documentation

• Contributor guide (this repo)

• Architecture

• Journey map

• Repository governance

• MCP reference

• Examples

• Skill references under skills/git-into-gsoc/references/

Development

python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pre-commit install
ruff check src tests && ruff format --check src tests
mypy src
pytest

See CONTRIBUTING.md for Conventional Commits, squash-merge PRs, and release process.

License

MIT — see LICENSE.

Disclaimer

Google Summer of Code and GSoC are trademarks of Google LLC. This project is not affiliated with or endorsed by Google. Always verify dates, orgs, and rules on the official program site.