# kasper/phoenix

A lightweight macOS window and app manager scriptable with JavaScript

Repository: https://github.com/kasper/phoenix
Canonical: https://ross.abutalabs.com/products/kasper-phoenix
Homepage: https://kasper.github.io/phoenix/
Language: Objective-C
License: NOASSERTION
License Family: other
Last push: 2025-08-31T15:27:29+00:00

## Health v2 (maintenance only)
Score: 40/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 39, release rhythm 8, longevity 100
- inputs: {"age_days": 4436, "days_push": 367, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4542, forks 125 (observed 2026-08-28T04:08:53.144488+00:00)

## What it is
Phoenix is a lightweight macOS window and app manager that is scriptable with JavaScript (or TypeScript). It lets users bind keyboard shortcuts and system events to control screens, spaces, mouse, apps, and windows with a small footprint.

## Use cases
- script custom window management on macOS with JavaScript
- bind keyboard shortcuts to move and resize windows
- automate macOS app and space management
- center or tile the focused window with a hotkey
- run external commands from system event triggers
- build a personal lightweight window manager instead of using a heavy app

## When to choose
- you want a minimal, efficient macOS window manager you can script yourself in JavaScript or TypeScript
- you prefer writing your own configuration over a prebuilt tiling manager
- you need to bind shortcuts and system events to control windows, apps, screens, and spaces

## When to avoid
- you want an out-of-the-box tiling window manager with no scripting
- you are not on macOS 10.14 or higher
- you prefer GUI-based window management configuration over code

## Facets
- artifact type: application
- maturity: active
- function: developer-tools, workflow-automation, gui
- domain: desktop-applications, developer-tools
- platform: -
- tags: window-manager, macos-automation, javascript-scripting, keyboard-shortcuts, tiling, automation, macos

## Member repositories
- kasper/phoenix (main) score 40

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:53.144488+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:20:09.133030+00:00, confidence not recorded.
  - readme: https://github.com/kasper/phoenix (fetched 2026-08-28T04:08:53.144488+00:00, sha a1666f693dec)
  - homepage: https://kasper.github.io/phoenix/ (fetched 2026-08-29T09:05:47.952095+00:00, sha c4b2ef6c342f)
- Data as of 2026-08-30T08:39:29.467469+00:00.