[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73376":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":14,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":24,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":29,"readmeContent":30,"aiSummary":31,"trendingCount":16,"starSnapshotCount":16,"syncStatus":32,"lastSyncTime":33,"discoverSource":34},73376,"RepoBar","steipete\u002FRepoBar","steipete","Show status of GitHub Repos right in your menu bar and terminal: CI, Issues, Pull Requests, Latest Release.","https:\u002F\u002Frepo.bar",null,"Swift",2073,120,8,1,0,3,64,9,28.25,"MIT License",false,"main",true,[26,27,28],"github","macos","statistics","2026-06-12 02:03:12","# 🚦 RepoBar\n\nRepoBar is a native macOS menu bar app for keeping GitHub work visible without living in a browser. It shows the repositories you care about, their current issue and PR pressure, recent activity, CI state, releases, local checkout status, and rate-limit health in a compact menu.\n\n![RepoBar screenshot](docs\u002Fassets\u002Frepobar.png)\n\nRepoBar is built for people who move between many repositories and need fast answers:\n\n- What changed recently?\n- Which repos have open issues or pull requests?\n- Did CI move?\n- Is my local checkout clean or behind?\n- Am I about to run into GitHub rate limits?\n- Can I inspect issues, PRs, releases, branches, tags, and commits without opening a dozen tabs?\n\n## Install\n\nHomebrew is the recommended install path:\n\n```bash\nbrew install --cask repobar\n```\n\nDirect downloads are available from the [latest GitHub release](https:\u002F\u002Fgithub.com\u002Fsteipete\u002FRepoBar\u002Freleases\u002Flatest).\n\n## What It Shows\n\nRepoBar's main menu is a repository dashboard:\n\n- Repository cards with issue count, PR count, stars, forks, latest activity, and optional heatmaps.\n- A contribution header for the signed-in GitHub account.\n- Filters for all repositories, pinned repositories, local repositories, and work-focused views.\n- A profile submenu with recent GitHub activity.\n- A GitHub API status submenu showing current blockers, live REST\u002FGraphQL state, and persisted REST resource headers.\n- Quick access to Preferences, About, and Quit.\n\nEach repository has a rich submenu:\n\n- Open the repository in GitHub.\n- Open or checkout the local repo when configured.\n- View local branch, ahead\u002Fbehind, dirty files, and worktrees.\n- Browse recent issues, pull requests, releases, CI runs, discussions, tags, branches, contributors, commits, and activity.\n- Preview changelog entries from a local `CHANGELOG.md` when available.\n- Pin, unpin, or hide the repository.\n\n## Repository Browser\n\nPreferences > Repositories is a real repository browser. It searches repositories RepoBar can access and lets you choose what appears in the menu:\n\n- `Visible` keeps the repo available through normal sorting and filtering.\n- `Pinned` keeps the repo near the top.\n- `Hidden` removes it from the menu.\n- Manual rules remain visible even if a token or GitHub App installation no longer returns the repo, which makes access problems easier to diagnose.\n\nRepoBar can see public repositories, user repositories, collaborator repositories, and organization repositories that the current authentication method is allowed to access.\n\n## Authentication And Private Repos\n\nRepoBar supports GitHub.com and GitHub Enterprise.\n\nFor GitHub.com, RepoBar uses a GitHub App user token and does not request broad classic OAuth repository scopes. Access is bounded by:\n\n- the signed-in user's GitHub permissions, and\n- where the [RepoBar GitHub App](https:\u002F\u002Fgithub.com\u002Fapps\u002Frepobar\u002Finstallations\u002Fnew) is installed.\n\nPrivate organization repositories require the RepoBar GitHub App to be installed on that organization or selected repositories. If an organization requires SAML SSO, or if you need access outside the GitHub App installation boundary, use a Personal Access Token with `repo` and `read:org`.\n\nGitHub Enterprise uses the configured enterprise host and OAuth settings. TLS is required.\n\nRelease builds store tokens in the macOS Keychain. Debug builds and SwiftPM CLI\u002Ftest runs default to file-backed auth storage so local development does not trigger Keychain prompts. See [docs\u002Fauth-storage.md](docs\u002Fauth-storage.md).\n\n## Local Projects\n\nRepoBar can scan a local projects folder such as `~\u002FProjects` and match local checkouts to GitHub repositories.\n\nLocal state appears directly in the menu:\n\n- current branch\n- upstream branch\n- ahead\u002Fbehind counts\n- dirty file summary\n- worktree state\n- fast-forward sync status\n\nOptional auto-sync fetches and fast-forwards clean repositories on a configurable cadence. It does not force-push, hard-reset, or discard local changes. See [docs\u002Freposync.md](docs\u002Freposync.md).\n\n## Caching, Archives, And Rate Limits\n\nRepoBar is designed to open from local data first and spend GitHub requests carefully.\n\nIt stores REST ETags, response bodies, GraphQL responses, recent lists, repository detail data, and rate-limit state in RepoBar-owned storage. First-open menu rows can be seeded from the persistent cache, then refreshed in the background.\n\nGitHub core limits are usually shared by the GitHub user or integration actor, not by each token string. A PAT, another OAuth app, another GitHub App user token, and `gh` CLI requests for the same account can draw from one shared user budget. The `gh` CLI may keep working after other requests are blocked because GitHub grants that app extra allowance, but using `gh` still spends the normal user budget first.\n\nThe optional typed GitHub reference monitor is cache-first too: when enabled in Advanced settings, RepoBar watches issue-number patterns and commit-like hashes, looks for matching cached issues, pull requests, or commits in accessible repositories, and falls back to live GitHub lookups on cache misses. The best match appears as a separate menu bar item that opens in your default browser. Global monitoring requires granting RepoBar Accessibility permission in System Settings.\n\n### Sync With Gitcrawl Archives\n\nRepoBar reads GitHub backup archives that follow the [gitcrawl.sh](https:\u002F\u002Fgitcrawl.sh) portable-store format — a Git-backed SQLite snapshot with `manifest.json` plus `tables\u002F\u003Ctable>\u002F*.jsonl(.gz)` files. Point RepoBar at any compatible snapshot repository and it imports cleanly into its own SQLite cache.\n\nWhen GitHub is rate-limited, offline, or temporarily unavailable, issue and pull request lists are answered from the imported archive automatically — the menu does not go blank.\n\nRepoBar owns its own cache and archive configuration: it does not read gitcrawl config and does not write to gitcrawl databases. The archive contract is the on-disk snapshot shape, not a runtime dependency.\n\nThe current cache and archive behavior is documented in [docs\u002Fcache.md](docs\u002Fcache.md). The CLI can inspect this state:\n\n```bash\nrepobar cache status --plain\nrepobar cache status --json\nrepobar archives list\nrepobar archives status\n```\n\n## CLI\n\nRepoBar ships a `repobar` CLI for automation and debugging. It mirrors the app's GitHub and cache paths closely enough to be useful when diagnosing menu behavior.\n\nExamples:\n\n```bash\nrepobar login\nrepobar repos --plain\nrepobar repos --owner openclaw --sort prs --plain\nrepobar repo openclaw\u002Fopenclaw --plain\nrepobar issues openclaw\u002Fopenclaw --limit 20 --plain\nrepobar pulls openclaw\u002Fopenclaw --limit 20 --plain\nrepobar activity steipete --include-repos --limit 10 --plain\nrepobar rate-limits --plain\nrepobar cache status --plain\n```\n\nUse `--json` for machine-readable output and `--plain` for output without colors, links, or terminal decoration.\n\nFull reference: [docs\u002Fcli.md](docs\u002Fcli.md).\n\n## Development\n\nRepoBar is a SwiftPM-based macOS app wrapped by `pnpm` scripts.\n\nRequirements:\n\n- macOS\n- Xcode 26 \u002F Swift 6.2\n- pnpm 10+\n\nInstall script dependencies once:\n\n```bash\npnpm install\n```\n\nCommon commands:\n\n```bash\npnpm check     # swiftformat + swiftlint + swift test\npnpm test      # Swift Testing suite\npnpm build     # debug Swift build\npnpm start     # build, package, sign, and launch the app\npnpm restart   # relaunch the app from this checkout\npnpm stop      # quit RepoBar\n```\n\nAlways launch local builds through `pnpm start` or `pnpm restart`. If the menu does not match the code you just edited, verify the running binary:\n\n```bash\npgrep -af \"RepoBar.app\u002FContents\u002FMacOS\u002FRepoBar\"\n```\n\n## Project Layout\n\n- `Sources\u002FRepoBar\u002F` - macOS app, menu, settings, auth coordination, local project UI.\n- `Sources\u002FRepoBarCore\u002F` - GitHub client, cache\u002Farchive readers, models, settings, local Git services.\n- `Sources\u002Frepobarcli\u002F` - command-line interface.\n- `Tests\u002FRepoBarTests\u002F` - Swift Testing coverage.\n- `docs\u002F` - design notes and operational docs.\n- `Scripts\u002F` - build, package, signing, testing, and launch wrappers.\n\nUseful docs:\n\n- [docs\u002Fspec.md](docs\u002Fspec.md) - product and technical spec.\n- [docs\u002Fcache.md](docs\u002Fcache.md) - persistent cache and archive design.\n- [docs\u002Fcli.md](docs\u002Fcli.md) - CLI command reference.\n- [docs\u002Fauth-storage.md](docs\u002Fauth-storage.md) - Keychain vs debug file-backed token storage.\n- [docs\u002Freposync.md](docs\u002Freposync.md) - local project scanning and sync behavior.\n- [docs\u002Frelease.md](docs\u002Frelease.md) - release checklist.\n\n## Status\n\nRepoBar is early and moving quickly. The latest released version is 0.5.0, with smarter persistent caching, archive-backed fallback paths, rate-limit visibility, GitHub reference previews, and more robust menu behavior.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","RepoBar 是一个 macOS 菜单栏应用，用于实时展示 GitHub 仓库的状态，包括持续集成状态、问题、拉取请求和最新发布。它采用 Swift 语言开发，具有简洁的用户界面，能够快速概览多个仓库的关键信息如最近活动、CI 状态、本地检出状态及 GitHub API 限制情况。此外，还支持通过 GitHub App 进行身份验证以访问私有仓库。该工具非常适合需要频繁切换于多个 GitHub 项目间工作的开发者或团队使用，帮助他们高效管理与跟踪项目进展，减少在浏览器中切换页面的麻烦。",2,"2026-06-11 03:45:14","high_star"]