Repo brief: jacklandrin/OnlySwitch

Generated by RepoPilot · document generated 2026-09-12 · concise human review Evidence snapshot · analyzed 2026-09-12T16:32:31.204Z · commit 24a8447c4b24

Verdict

Mixed — Evidence incomplete — review before adopting

• Last commit 6w ago
• 5 active contributors
• MIT licensed
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

OnlySwitch is a SwiftUI-based macOS menu bar app that provides a unified control panel for system toggles (dark mode, hide notch, AirPods, screen saver, low power mode, night shift, etc.) and allows importing and executing macOS Shortcuts from a single menu bar icon. It reduces menu bar clutter by consolidating dozens of independent system controls into one all-in-one switch with keyboard shortcut support and widget integration (macOS Sonoma+). SPM-based modular structure: Modules/Package.swift defines a reusable Swift package containing Defines/ (SwitchError, UnitType, notifications), Design/ (AppKitProgressView, SecureInputView), Extensions/ (64+ extensions for AppKit/SwiftUI…

Start here

Open these first:

• Modules/Package.swift — SPM package definition for the shared module library; all features depend on this module structure
• Modules/Sources/OnlyAgent/AgentCommand.swift — Core AI agent command execution framework; implements the primary autonomous task-execution paradigm
• Modules/Sources/Defines/NotificationNames.swift — Central event notification registry; enables loose coupling between menu bar switches and system observers
• Modules/Sources/Extensions/KeychainManager.swift — Unified credential storage abstraction; required for API key management across all AI model providers
• Modules/Sources/Networking/GitHub/GitHubInteractor.swift — GitHub API orchestration layer; handles release checking and version management for auto-updates

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/jacklandrin/OnlySwitch.git
cd OnlySwitch
open OnlySwitch.xcodeproj

Then build in Xcode (⌘B) or install via Homebrew: brew install only-switch.

Daily commands:

Open OnlySwitch.xcodeproj in Xcode and press ⌘R to run. The app launches as a background menu bar app; no dev server. Build scheme is OnlySwitch (not OnlyAgent which is a companion daemon in Modules/).

Key cautions & unknowns

• Concentrated ownership — top contributor handles 75% of recent commits
• Could not verify CI from the available repository evidence
• Keychain storage: Credentials stored via KeychainManager require matching Team ID on code-sign; mismatches silently fail. Low power mode toggle: Requires user password input (flagged as limitation in feature…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.