Repo brief: Caldis/Mos

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T21:07:46.078Z · commit 8a2fd112e2af

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit 3w ago
• 9 active contributors
• CI configured
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against OpenSSF Scorecard

What it is

Mos is a macOS menu-bar utility (written primarily in Swift with TypeScript/Electron UI components) that intercepts and smooths mouse scroll wheel events using interpolation, allowing independent axis control (vertical/horizontal can be configured separately), and enables custom button remapping for mice and Logitech devices via HID++ protocol. It transforms rigid scroll-wheel precision into trackpad-like fluidity while preserving per-application and per-direction override rules. Monorepo structure: Mos/ contains the primary Swift app entry (AppDelegate.swift, Assets.xcassets for UI resources), Mos.xcodeproj/ holds the Xcode build configuration and workspace metadata.…

Start here

Open these first:

• Mos/AppDelegate.swift — Application entry point and lifecycle manager; every contributor must understand how the app initializes and manages core…
• Mos.xcodeproj/project.pbxproj — Build configuration and project structure; defines all targets, dependencies, and compilation settings.
• CONTRIBUTING.md — Contribution guidelines; establishes workflow expectations and submission standards for pull requests.
• LOCALIZATION.md — Localization framework and language support conventions; required reading for adding or modifying multilingual content.
• Mos.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved — Locked dependency versions; ensures reproducible builds across all contributors.

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.

1. Clone: git clone https://github.com/Caldis/Mos.git && cd Mos
2. Open in Xcode: open Mos.xcodeproj
3. Build: Product → Build (or ⌘B in Xcode)
4. Run: Product → Run (or ⌘R in Xcode) Note: macOS 10.13+ required; Accessibility permissions must be granted on first launch.

Daily commands:

1. In Xcode, ensure the Debug scheme is selected (Mos.xcodeproj/xcshareddata/xcschemes/Debug.xcscheme).
2. Press ⌘R to build and run.
3. Grant Accessibility permissions when prompted (System Preferences → Security & Privacy → Accessibility).
4. App appears in menu bar; click to open settings.

Key cautions & unknowns

• Single-maintainer risk — top contributor 88% of recent commits
• Scorecard: default branch unprotected (0/10)
• 1. Accessibility permissions are non-negotiable: the app will not intercept scroll events without explicit user grant in System Preferences → Security & Privacy → Accessibility. 2. Notarization/code-signing:…
• License evidence is incomplete or ambiguous.
• 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
• OpenSSF Scorecard

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.