Repo brief: lwouis/alt-tab-macos

Generated by RepoPilot · document generated 2026-09-17 · concise human review Evidence snapshot · analyzed 2026-09-17T02:58:21.061Z · commit 2f3c67739211

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit 1d ago
• 3 active contributors
• GPL-3.0 licensed
• CI configured

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

alt-tab-macos is a macOS application that replicates the Windows Alt+Tab window-switching experience on Apple devices. Written primarily in Swift, it intercepts keyboard events, gestures, and trackpad input to provide fast window enumeration and visual presentation, solving the muscle-memory problem for users switching between Windows and macOS. Monolithic single-app architecture organized by event domain: src/events/ contains specialized event handlers (KeyboardEvents.swift, TrackpadEvents.swift, WindowCaptureEvents.swift, etc.), src/kit/ provides custom UI components, src/api/ manages endpoints and secrets, and src/debug/ offers benchmarking and QA tools. State and configuration are…

Start here

Open these first:

• src/main.swift — Application entry point; initializes the app lifecycle and delegates to main components.
• src/App.swift — Core application orchestrator that wires together event handlers, preferences, and window management.
• src/events/KeyboardEvents.swift — Central keyboard event capture and hotkey routing; implements the primary alt-tab trigger mechanism.
• src/preferences/Preferences.swift — Application-wide preferences schema and persistence layer; every configuration flows through here.
• src/macos/api-wrappers/AXUIElement.swift — Wraps macOS Accessibility API for window introspection and manipulation; foundation for window cycling.

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.

Verify Node.js >=18.0.0 is installed, then:

git clone https://github.com/lwouis/alt-tab-macos.git
cd alt-tab-macos
npm install

Note: This is a macOS application; building and running requires Xcode and a macOS machine. Check the repository documentation (not provided here) for Xcode project setup and build steps.

Daily commands:

Evidence is insufficient to provide exact build/run commands. package.json contains only development tools (formatting, linting, release automation), not application build scripts. Verify the repository's Xcode project…

…shortened for this brief.

Key cautions & unknowns

• Small team — 3 contributors active in recent commits
• Single-maintainer risk — top contributor 91% of recent commits
• GPL-3.0 is copyleft — check downstream compatibility
• Accessibility permissions required: The app relies on AX (accessibility) queries (AxQueryRouting.swift) and will fail silently or partially if macOS accessibility permissions are not granted. **Event loop…
• 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.