What is maintainer-bar?

A workflow for operating MaintainerBar, a macOS menu-bar app for maintaining GitHub repositories. It connects to ghcrawl, a local tool that groups related issues and supports semantic search.

Use it to refresh GitHub issue data, group related issues, search issues by meaning, check repository activity, manage notifications, and build or run the SwiftUI app.

It brings repository health checks, issue clustering, search, notifications, and data refreshes into one documented workflow. It also describes how to build and run the app and its backend.

maintainer-bar — Skill for Claude Code and Codex by OpenCoven

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add OpenCoven/coven --skill maintainer-bar

Clone the repo

git clone --depth 1 https://github.com/OpenCoven/coven

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/opencoven/coven/maintainer-bar.svg)](https://agentmods.dev/skills/opencoven/coven/maintainer-bar)

Your own site

<a href="https://agentmods.dev/skills/opencoven/coven/maintainer-bar"><img src="https://agentmods.dev/badge/skills/opencoven/coven/maintainer-bar.svg" alt="Measured on agentmods" height="20"></a>

Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,035 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00052	$0.01035
Opus 5	$0.00026	$0.00517
Sonnet 5	$0.00010	$0.00207
Haiku 4.5	$0.00005	$0.00103

Measured 7d ago against content hash 1f3bb5d96eee, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

maintainer-bar scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/maintainer-bar/SKILL.md · 132 lines

How it starts

The opening of the file, as written. The whole thing — 132 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Overview

MaintainerBar is a native macOS SwiftUI menu bar app for GitHub repo maintenance. It's backed by ghcrawl (local SQLite + OpenAI embeddings) for issue/PR clustering and semantic search.

Repo: ~/Documents/GitHub/OpenKnots/MaintainerBar Stack: SwiftUI (Swift Package Manager), macOS 14+ Backend: ghcrawl CLI (JSON mode) + GitHub API via gh Host: MB Black (macOS node)

Prerequisites

ghcrawl installed: ~/.nvm/versions/node/v24.13.0/bin/ghcrawl
Wrapper: ~/.local/bin/ghcrawl-op (injects GitHub token via gh auth + OpenAI key via 1Password)
Xcode 26+ / Swift 6.0+
gh CLI authenticated
op CLI (1Password) for OpenAI key

Build & Run

# Build
cd ~/Documents/GitHub/OpenKnots/MaintainerBar
swift build

# Run (debug)
swift run MaintainerBar

# Run built binary directly
.build/debug/MaintainerBar

ghcrawl Operations (via wrapper)

All ghcrawl commands should use the ghcrawl-op wrapper or inject env vars:

# Refresh a repo (sync + embed + cluster)
~/.local/bin/ghcrawl-op refresh openclaw/openclaw

# List clusters (JSON)
~/.local/bin/ghcrawl-op clusters openclaw/openclaw --min-size 2 --limit 30 --json

# Semantic search
~/.local/bin/ghcrawl-op search openclaw/openclaw --query "download stalls" --json

# Cluster detail
~/.local/bin/ghcrawl-op cluster-detail openclaw/openclaw --id 123 --json

# Specific threads
~/.local/bin/ghcrawl-op threads openclaw/openclaw --numbers 42,43,44 --json

# Author's open issues
~/.local/bin/ghcrawl-op author openclaw/openclaw --login someone --json

# Health check
~/.local/bin/ghcrawl-op doctor --json

Architecture

Sources/
├── MaintainerBarApp.swift      # @main entry, MenuBarExtra
├── Models/
│   ├── AppState.swift          # @MainActor ObservableObject
│   └── Models.swift            # IssueCluster, SearchResult, etc.
├── Services/
│   └── GhcrawlService.swift    # Actor wrapping ghcrawl CLI calls
└── Views/
    ├── MenuBarView.swift       # Main container with tabs
    ├── ClustersView.swift      # Issue cluster browser
    ├── SearchView.swift        # Semantic search
    ├── NotificationsView.swift # GitHub notifications (WIP)
    └── PulseView.swift         # Repo health dashboard (WIP)

Read the full file on GitHub · 132 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

7d ago First seen · 132 lines · 52 tokens per session scan A 1f3bb5d96eee

Subscribe to this mod's changes

maintainer-bar is a skill published in the GitHub repository OpenCoven/coven (47 stars, last pushed 2d ago), licensed MIT. It adds 52 tokens to every session and 1,035 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Claude Code Git and workflow Productivity agent-orchestration ai-agents codex ghcrawl github macos maintainer menu-bar model-agnostic opencoven swiftui

onlyswitch-deeplink

Invoke OnlySwitch built-in switches or buttons via deeplink. Use when the user asks to toggle or trigger an OnlySwitch action (e.g. empty trash, keep awake, dark mode, mute, hide desktop, clear clipboard, eject discs, Xcode derived data, and any other built-in switch or button). Resolve the request to the correct…

jacklandrin/OnlySwitch · 85 tokens

checkpoint-management

Git-backed state management for safe rollback. Create and restore checkpoints with tagged commits and metadata tracking.

a5c-ai/babysitter · 22 tokens

implement

Implement a Jira ticket — fetches ticket, checks for existing plan, creates worktree branch, runs implementation with verification. Usage - /implement IN-XXX.

ShreyPaharia/octomux · 33 tokens

pull-request-automation

Audits and improves the pull request workflow for a GitHub repository. Covers PR description templates, auto-labelling, CODEOWNERS, PR size checks, and branch protection rules. Invoked when the user asks to improve the PR process, set up PR automation, or add a PR template.

soulcodex/agentic · 65 tokens

apple-notes-search

Semantic + keyword search and connection-discovery across the user's own Apple Notes via the apple-notes MCP server. Use when the user wants to find, recall, or synthesize something from their notes, or surface non-obvious bridges/related notes. macOS, on-device.

Ghosteken/agent-harness · 61 tokens

wrap-session

Wrap up the current session by updating active.md, logging the session, committing, and providing the next session's starter prompt. Use at the end of every working session.

FarzamMohammadi/the-engineer · 37 tokens

maintainer-bar