Repo brief: ianyh/Amethyst

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T20:12:21.508Z · commit 34e35629a11a

Verdict

Healthy — Strong maintenance signals

• Last commit 5w ago
• 26+ active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

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

What it is

Amethyst is an automatic tiling window manager for macOS written in Swift that mimics xmonad's behavior, allowing users to organize and resize windows automatically into predefined layouts (tall, wide, fullscreen, etc.) via keyboard shortcuts rather than manual dragging. It solves the macOS gap in productivity-focused, keyboard-driven window management for developers and power users accustomed to tiling managers on Linux. Single Xcode project (Amethyst.xcodeproj) with workspace structure. Core logic in Amethyst/ folder organized by concern: Categories/ for extensions, Events/ for HotKeyManager, Debug/ for introspection tools, and Base.lproj/ for UI. Configuration via .amethyst.sample.yml.…

Start here

Open these first:

• Amethyst/AppDelegate.swift — Application entry point and lifecycle manager; initializes the window manager, hot key system, and app state.
• Amethyst/Managers/WindowManager.swift — Core engine managing window layouts, reflow operations, and accessibility-based window manipulation; all tiling logic flows…
• Amethyst/Managers/ScreenManager.swift — Handles multi-monitor support and workspace management; critical for tracking screens and delegating layouts per display.
• Amethyst/Layout/Layout.swift — Abstract layout protocol and base implementation; all layout algorithms inherit from or conform to this interface.
• Amethyst/Events/HotKeyManager.swift — Keyboard shortcut registration and dispatch system; bridges user input to all window/layout operations.

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/ianyh/Amethyst.git
cd Amethyst
open Amethyst.xcworkspace
# In Xcode: Product > Scheme > Amethyst > Run

Requires Xcode 12+ and macOS 10.15+. Build via Xcode GUI or xcodebuild -workspace Amethyst.xcworkspace -scheme Amethyst.

Daily commands:

Open Amethyst.xcworkspace in Xcode and press Product > Run, or: xcodebuild -workspace Amethyst.xcworkspace -scheme Amethyst -configuration Debug build. Debug CLI available via 'Amethyst Debug CLI' scheme. App runs as…

…shortened for this brief.

Key cautions & unknowns

• Concentrated ownership — top contributor handles 70% of recent commits
• Accessibility permission requirement: Amethyst must be granted Accessibility API access in System Preferences → Security & Privacy → Accessibility; silently fails without it. Space rearrangement conflict: macOS…
• 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.