rekap

See exactly where you left off in any git repo — and what's active across any GitHub org.

You open a project after days away. No idea what branch you were on, what you changed, whether it's clean. Instead of running git log, git status, and git branch separately — rekap shows everything in one clean view.

Quick Start

npx @abhivarde/rekap

No install required. Run it inside any git repo.

Install Globally

npm install -g @abhivarde/rekap

Usage

$ rekap                           current repo
$ rekap [path]                    specific repo
$ rekap org <name>                top 8 recently updated public repos
$ rekap org <name> --sort stars   top 8 by stars
$ rekap org <name> --sort forks   top 8 by forks
$ rekap --all [dir]               scan all repos in a directory
$ rekap --open                    open current branch in browser
$ rekap --watch                   live-refresh every 3s
$ rekap --json                    machine-readable output
$ rekap --help                    show help

Repo Summary

What you see when you run rekap inside a git repo:

| Field | Description | | ---------------- | --------------------------------------------------- | | branch | Current branch with ↑ahead / ↓behind upstream | | remote | Remote origin (auth tokens stripped automatically) | | last | Time since last commit, color-coded by age | | version | Nearest git tag | | recent commits | Last 5 commits with conventional commit type colors | | uncommitted | Clean or list of changed files with status | | stashes | Number of stashed changes | | languages | Codebase breakdown with proportional bars | | grade | A–F health score |

Health Grade

| Grade | Meaning | | ----- | ----------------------------------- | | A | Clean, up-to-date | | B | Good shape | | C | Some uncommitted work or mild drift | | D | Messy or significantly behind | | F | Needs immediate attention |

Grade is calculated from uncommitted files, commits behind upstream, and stash count.

Org Intelligence

Scan any public GitHub org instantly. No token required.

rekap org vercel-labs
rekap org appwrite --sort stars
rekap org AbhiVarde --sort forks

Shows the top 8 repos sorted by your choice — recently updated (default), most starred, or most forked. Useful for tracking what an org is actively shipping, finding repos to contribute to, and discovering what's worth forking.

Multi-Repo Scan

# See all repos under ~/Projects at once
rekap --all ~/Projects

Useful for a morning check across all your active projects.

JSON Output

rekap --json

Pipes cleanly into jq or any script:

rekap --json | jq '.grade'
rekap --json | jq '.languages[0].lang'

Development

git clone https://github.com/AbhiVarde/rekap
cd rekap
npm install

# Test on current repo
node index.js

# Test org feature
node index.js org vercel-labs
node index.js org appwrite --sort stars

# Test multi-repo scan
node index.js --all ~/Projects

# Test JSON output
node index.js --json

Only one dependency: chalk for terminal colors.

Contributing

1. Fork and clone the repo
2. Make changes in index.js
3. Test with node index.js inside a git repo
4. Open a pull request

License

MIT © Abhi Varde