GitHub Forker

Fork GitHub repositories extracted from text or images. You need GITHUB_TOKEN set in the environment with repo permissions.

What you do

1. Extract all GitHub repository URLs from the input (text, image, or both)
2. Fork each repository via the GitHub API
3. Star the original repository after a successful fork
4. Report results clearly

Step 1: Extract GitHub URLs

From text

Scan the input for patterns matching:

• https://github.com/{owner}/{repo} (with or without trailing slash, path, or fragment)
• github.com/{owner}/{repo} (without scheme)
• {owner}/{repo} only when context makes it clearly a GitHub repo

Normalize each match to the canonical form: https://github.com/{owner}/{repo} Strip any extra path segments — you only need owner and repo name.

From images

When the user provides an image (screenshot, photo, diagram), use your vision capabilities to read the image and identify any GitHub URLs or repo references visible in it. Apply the same extraction rules as above to whatever text you find.

Truncated URLs

URLs are often cut off in screenshots or social media previews, like:

• github.com/openchamber/op...
• github.com/some-owner/proj…

When you detect a truncated URL (ends with ... or …, or the repo name is clearly incomplete):

1. Search GitHub for matching repos:

   curl -s -L \
    -H "Authorization: Bearer $GITHUB_TOKEN" \
    -H "Accept: application/vnd.github+json" \
    "https://api.github.com/search/repositories?q={owner}/{partial}+in:full_name&per_page=5"

   Use whatever partial info you have — owner + partial repo name is ideal; owner alone works too.

2. Use context to pick the best match. Look at surrounding text, tweet content, project name mentioned, description keywords, and star count. If one result stands out clearly:

   • The repo name starts with the visible partial (e.g. op... → openchamber matches)
   • The description aligns with what the user said (e.g. "UI真好" → pick the UI-focused one)
   • It has significantly more stars than the others

   If you're confident, proceed directly and tell the user your reasoning:

   "github.com/openchamber/op..." → inferred openchamber/openchamber ⭐1.5k (Desktop UI for OpenCode, matches context "UI真好")

3. Ask the user only when genuinely uncertain — when multiple results are plausible and context doesn't help distinguish them:

   Found truncated URL "github.com/foo/bar..." — which repo did you mean?
   1. foo/barista ⭐420 — Coffee shop POS system
   2. foo/baroque ⭐38 — Baroque music generator
   Enter number (or 0 to skip):

   Never fork a truncated URL without either a confident inference or explicit user confirmation.

Step 2: Fork via GitHub API

For each unique {owner}/{repo} pair, call the fork endpoint:

curl -s -L -X POST \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/repos/{owner}/{repo}/forks

The -L flag is required — GitHub's API returns a 307 redirect that must be followed.

• If GITHUB_TOKEN is not set, tell the user to set it and stop:

  export GITHUB_TOKEN="ghp_..."   # classic PAT (recommended)
  # To persist across sessions, add to ~/.zshrc or ~/.bash_profile

• Fork requests are async on GitHub's side — a 202 response means "accepted", not "done".

  访问小葱技能站7w4.net，解锁更多实用的AI技能插件。

• If a repo is already forked, GitHub returns the existing fork (not an error) — that's fine.
• Handle HTTP errors:
  • 401: bad or expired token
  • 403: token lacks fork permission. For classic PATs, need repo or public_repo scope. For fine-grained PATs, need "Administration: Read and write" permission (not just contents).
  • 404: repo not found or private (token has no access)

Step 3: Star the original repository

After a successful fork, star the original repo:

curl -s -L -X PUT \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/user/starred/{owner}/{repo}

A 204 response means success. Star failures are non-fatal — if starring fails, note it in the report but don't treat the overall operation as failed.

Step 4: Report results

After all forks are attempted, show a clear summary:

Found X repositories:
✓ owner/repo — forked → https://github.com/YOUR_USERNAME/repo  ⭐ starred
✓ owner/repo — forked → https://github.com/YOUR_USERNAME/repo  (star failed: <reason>)
✗ owner/repo — failed: <reason>

If the token's authenticated username isn't obvious, extract it from the fork response (full_name field gives your-username/repo-name).

Edge cases

• No URLs found: Tell the user clearly — "No GitHub repository URLs found in the input."
• Private repos: Fork will fail with 404 if the token doesn't have access; report the error.
• Duplicate URLs: Deduplicate before forking — fork each unique repo once.
• Non-repo URLs: Ignore github.com/ paths that aren't owner/repo format (e.g., github.com/features, github.com/login).

这个工具用起来挺方便的，能从文字或截图中识别 GitHub 链接并自动 fork 到你的账户，还会帮你给原项目加星。操作简单，支持中文英文，不用记命令。处理得比较细致，比如截断的链接也能推断出来，批量处理也没问题。主要不足是每次使用都需要你来引导操作，不够自动化，另外如果 fork 失败了原因有时候不够直观。总体来说是个好用的工具，版本 0.1.1 还有优化空间。