Skip to content
Skills Library
Programming · Research

gitcrawl

/gitcrawl

Use for local GitHub issue/PR archive search, sync freshness, clusters, durable maintainer triage, handoff to Octopool-backed gh reads, and Gitcrawl repo/release work.

Repository
gitcrawl ↗
Licence
MIT
Last repository change
24.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 24.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use for local GitHub issue/PR archive search, sync freshness, clusters, durable maintainer triage, handoff to Octopool-backed gh reads, and Gitcrawl repo/release work.

Original author description

Use for local GitHub issue/PR archive search, sync freshness, clusters, durable maintainer triage, handoff to Octopool-backed gh reads, and Gitcrawl repo/release work.

How it works

  1. Sources
  2. Freshness
  3. Query Workflow
  4. SQL
  5. Maintainer Boundaries
  6. Verification
Original SKILL.md headings · 154 lines, 789 words
SKILL.md preview
---
name: gitcrawl
description: Use for local GitHub issue/PR archive search, sync freshness, clusters, durable maintainer triage, handoff to Octopool-backed gh reads, and Gitcrawl repo/release work.
---

# Gitcrawl

Use local archive data first for GitHub issue and pull request questions. Browse
or hit live GitHub APIs only when the local archive is stale, missing the
requested scope, or the user asks for current external context.

## Sources

- Config: resolve with `gitcrawl doctor --json`; fresh macOS installs default to
  `~/Library/Application Support/gitcrawl/config.toml`, while Linux honors
  `${XDG_CONFIG_HOME:-~/.config}/gitcrawl/config.toml`
- DB: resolve with `gitcrawl doctor --json`; fresh macOS installs default to
  `~/Library/Application Support/gitcrawl/gitcrawl.db`, while Linux honors
  `${XDG_DATA_HOME:-~/.local/share}/gitcrawl/gitcrawl.db`; portable-store
  installs may point at a configured store database instead of the default local
  DB
- Cache: resolve with `gitcrawl init --json` for new installs or from
  `cache_dir` in config; fresh macOS installs default to
  `~/Library/Caches/gitcrawl`, while Linux honors
  `${XDG_CACHE_HOME:-~/.cache}/gitcrawl`
- Vectors: resolve with `gitcrawl init --json` for new installs or from
  `vector_dir` in config; fresh macOS installs default to
  `~/Library/Application Support/gitcrawl/vectors`, while Linux honors
  `${XDG_DATA_HOME:-~/.local/share}/gitcrawl/vectors`
- Legacy installs may still resolve config, database, cache, vectors, and logs
  under `~/.config/gitcrawl/`; check the active config before assuming a
  migrated path.
- Repo: `openclaw/gitcrawl`; on ClawSweeper this is checked out at `~/clawsweeper-workspace/gitcrawl`
- Preferred CLI: `gitcrawl`; fallback to `go run ./cmd/gitcrawl` from a verified repo checkout if the installed binary is stale

## Freshness

For recent/current questions, check freshness before analysis:

```bash
gitcrawl doctor --json
```

Routine refresh:

```bash
gitcrawl doctor
gitcrawl refresh owner/repo
```

Targeted refresh:

```bash
gitcrawl sync owner/repo --numbers 123,456 --with pr-details
```

`--with pr-details` hydrates PR files, commits, checks, workflow runs, and
review-thread resolution state in the local archive. Use it when the review
needs those details; it does not populate Octopool's separate `gh` cache.

For agent-driven discovery, prefer bounded freshness:

```bash
gitcrawl search issues "query" -R owner/repo --state open --sync-if-stale 5m --json number,title,url
```

## Query Workflow

1. Resolve scope: owner/repo, issue/PR number, cluster id, keyword, label, author, state, or date range.
2. Check freshness for recent/current requests.
3. Use CLI for normal reads; use read-only SQL for precise counts/rankings.
4. Report absolute date spans, repo names, issue/PR numbers, cluster ids, and known gaps.

Common commands:

```bash
gitcrawl search issues "query" -R owner/repo --state open --json number,title,url
gitcrawl clusters owner/repo --sort size --min-size 5
gitcrawl cluster-detail owner/repo --id <id>
gitcrawl threads owner/repo --numbers 123 --include-closed --json
```

For an exact PR, read the archive with `threads` first. `--include-closed`
keeps closed or merged candidates in scope; archive state is not proof of
current GitHub state. Then use bare PATH `gh` for fresh metadata when needed,
including before final merge/comment decisions:

```bash
gh pr view 123 -R owner/repo --json number,title,state,url,isDraft,headRefName,headRefOid
```

Drill down into checks only when needed:

```bash
gh pr checks 123 -R owner/repo --json name,state,bucket,link
```

Keep the existing Octopool-backed `gh` shim and use narrow JSON field lists so
supported reads share its cache. Native `gh` uses `headRefName`/`headRefOid`
for PR refs and `bucket`/`link` for check classification and URLs, not the old
Gitcrawl field names.

`gitcrawl gh` is removed and exits `2` with a migration note. Do not retry its
`status`, `view`, or `checks` recipes, pass its `--live`/`--cached` flags to
`gh`, or rebuild an older Gitcrawl to recover that cache. This is a command
migration, not an authentication failure: do not run `octopool login`, change
tokens, auth, PATH, or config, or bypass the existing shim to repair it. See
[the gh migration guide](../../../docs/gh-shim.md) for ownership and first-time setup.

## SQL

`gitcrawl` does not currently expose a first-class `sql` command. For exact
local archive counts or rankings, use SQLite read-only mode against the
configured DB and prefer CLI commands for normal reads.

Useful examples:

```bash
db="$(gitcrawl doctor --json | jq -r .db_path)"
sqlite3 -readonly "$db" \
  "select count(*) as threads from threads;"
sqlite3 -readonly "$db" \
  "select r.full_name, count(*) as threads from threads t join repositories r on r.id = t.repo_id group by r.full_name order by threads desc limit 20;"
sqlite3 -readonly "$db" \
  "select state, count(*) as threads from threads group by state;"
```

Do not run mutating SQL against the archive. Use local maintainer commands for
overrides instead of writing database rows directly.

When the installed CLI lacks a new feature, build or run from
a verified `openclaw/gitcrawl` checkout before concluding the feature is missing.

## Maintainer Boundaries

`close-thread`, `close-cluster`, exclusions, and canonical-member choices are
local maintainer overrides; they do not write back to GitHub. Use bare PATH
`gh` for authorized GitHub writes; Octopool handles fallback to the real CLI.
Gitcrawl no longer owns the `gh` shim or its configuration.

## Verification

For repo edits, prefer existing Go gates:

```bash
GOWORK=off go test ./...
```

Then run targeted CLI smoke for the touched surface, for example:

```bash
gitcrawl doctor --json
gitcrawl status --json
gitcrawl search issues "test" -R openclaw/gitcrawl --state open --limit 5
gitcrawl threads owner/repo --numbers 123 --include-closed --json
gh pr view 123 -R owner/repo --json number,title,state,url,headRefOid
```

Versions

The database has no other skills named gitcrawl.

Database snapshot: 13.11.2026 · package version acac99d6f851 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100notcrawl
    Use for local Notion archive search, sync freshness, Markdown/database exports, git-share snapshots, and Notcrawl repo/release work.
  • 100graincrawl
    Use for local Granola archive search, sync freshness, notes/transcripts/panels, Markdown export, snapshots, Keychain-safe source debugging, and Graincrawl repo/release work.
  • 100github-maintainer
    GitHub 仓库维护专用 agent。用户说「推上去」「提交」「建个仓库」「发个 release」「处理 issue/PR」「仓库改名」时使用。负责 git 提交、推送、建仓、改名、release、issue 管理,凭据已持久化,直接操作无需用户授权。
  • 100triage-issue
    Use when triaging a GitHub issue - analyzes issue, checks for duplicates, categorizes, and drafts response
  • 100plan-issue-triage
    Use when preparing a ready prompt for Claude, Codex, or another agent to perform a review-only GitHub issue triage or open-issue audit, especially broad scans such as all current issues, unlabeled issues, performance-regression clusters, close candidates, or customer-feedback parked work.
  • 100maintainer-triage
    Triages the open issues of a GitHub repo. Reads them with gh, sorts each into bug, feature, question, duplicate, needs-repro or stale, finds likely duplicates, and drafts labels plus a short, human reply for every issue. Writes a triage report first and only applies labels,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.