HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
kasper
phoenix
Objective-C2015–2024
kasper / phoenix

phoenix

A lightweight macOS window and app manager scriptable with JavaScript

16Distinct people
37Mentions
0Explicit recommenders
4.5KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

A lightweight macOS window and app manager scriptable with JavaScript

GitHub

Where it is used

No documented product use was verified in the last source check.

What people are saying

No recommendation phrase was found in the indexed comments.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 3:03:16 PM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year37 dated mentions

Observed mentions: 2015-11-28 20:24:15 UTC to 2024-12-13 17:42:18 UTC.

024682015-01-01 00:00:00 UTC to 2016-01-01 00:00:00 UTC (exclusive): 1 mentions; 1 submissions, 0 comments20152016-01-01 00:00:00 UTC to 2017-01-01 00:00:00 UTC (exclusive): 7 mentions; 4 submissions, 3 comments2017-01-01 00:00:00 UTC to 2018-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments2018-01-01 00:00:00 UTC to 2019-01-01 00:00:00 UTC (exclusive): 4 mentions; 1 submissions, 3 comments2019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments20192020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 5 mentions; 1 submissions, 4 comments2021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments2022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments2023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 8 mentions; 0 submissions, 8 comments2024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 5 mentions; 0 submissions, 5 comments2024

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20152015-01-01 00:00:00 UTC2016-01-01 00:00:00 UTC110
20162016-01-01 00:00:00 UTC2017-01-01 00:00:00 UTC743
20172017-01-01 00:00:00 UTC2018-01-01 00:00:00 UTC202
20182018-01-01 00:00:00 UTC2019-01-01 00:00:00 UTC413
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC202
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC514
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC202
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC101
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC808
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC505

What Hacker News says

37 sources
For my window management on mac os I wrote some javascript and use https://github.com/kasper/phoenix I will concede that macos default out of the box also has some UI/UX issues for people who are or want to be 'hands on keyboard 100% of the time' but there are a few tools out there that I've found for myself that solve many of the problems. Phoenix being one, but also recently homerow https://www.homerow.app/, when I was back on windows in the bad old days of the early 2000s I ran a lot of software to facilitate my workflows by tweaking the system ui/ux. But windows in my house is an overly expensive gaming console with occasional web browsing. MacOs is a very 'cozy' as you put it unix. Much of my job is also terminal based so having a standard shell is great (even though I'm still occasionally bitten by the 'i copied this stuff that work
Read the rest
ed in my terminal onto a linux machine and I forgot my grep/awk/whatever is BSD and not GNU.. fak'). I was excited back when MS announced the Linux Subsystem.. but man fuck ... so hacky. Also why the fuck is no one at MS replacing the standard terminal with something that actually functions properly? I mean sure I upgrade to iterm2 on macos, but using the built in termial is like 90% of the way there. The windows commandline shell (and not like the antique DOS stuff, and I can see that powershell is better, but not better enough that i'm going to bother with it.. like the actual terminal software is my biggest gripe) is simply garbage, no proper support even for the global clipboard as I recall.. different hotkeys than the rest of the system.
In Microsoft Discontinues iMac Rival Surface Studio 2
I always want to buy these types of apps (window management) but they rarely play nice with multiple monitors, especially if the monitors aren't all in the same orientation and/or if you want a smaller monitor to work differently. I've been using phoenix [0] for many years now for my window management which uses some JS config/code I wrote. It took a little bit for me to pick the hotkeys I wanted and how things should resize/move/jump monitors but now it's muscle memory. [0] https://github.com/kasper/phoenix
In Moom 4: Next-generation window manager
Interesting, I don’t have any of these issue due to 2 pieces of software: displayplacer [0] and Phoenix [1]. Both free and open source. displayplacer is a CLI tool that once you have your monitors configured how you want them, it can give you a command you can run in the future to reconfigure your monitors the same way again. I have 2 commands stored (that I activate via Alfred but I could have also set up aliases in zsh) for the 2 locations I work at. When I sit down I run the command and everything snaps into place. I could automate this to run automatically but I haven’t felt the need. Phoenix is a tool that lets me write my own keyboard shortcuts for window management. I have 1 key combo that detects which location I’m at (by looking at monitor UUIDs) then positions all my windows how I like them. I also have shortcuts for resizing wi
Read the rest
ndows on a monitor or moving windows between monitors. You can accomplish something similar with Moom [2] (paid) and Rectangle [3] (free) or Magnet [4] (paid). As for the dock issue, I use right-side dock with auto-hide and I don't find this bothersome at all. I use it plenty in addition to Alfred to launch apps. I have 3 monitors, 1 horizontal in the middle and 2 vertical on each side. Lastly the Menu Bar, I have it only on my center display, always visible. Never felt like that was a problem or limiting to me. [0] https://github.com/jakehilborn/displayplacer [1] https://github.com/kasper/phoenix [2] https://manytricks.com/moom/ [3] https://github.com/rxhanson/Rectangle [4] https://magnet.crowdcafe.com
In Multiple Displays on a Mac Sucks
In no particular order: Prologue [0] - iOS Audiobook player, used Plex as a media source Overcast [1] - iOS Podcast player CleanShotX [2] - macOS screenshot/video/gif capture with annotation Drafts [3] - iOS/macOS note taking tool Paprika [4] - Cross platform recipe app YNAB [5] - "You Need A Budget" - web/mobile budgeting app 1Password [6] - Cross platform password manager Carrot Weather [7] - iOS weather app Color Slurp [8] - macOS color picker tool Phoenix [9] - macOS scriptable window manager Alfred [10] - macOS app launcher Bartender [11] - macOS menu bar organizer Coderunner [12] - macOS tool to run snippets of code in a number of supported languages. Great for testing something quickly DaisyDisk [13] - macOS disk space analyzer iTerm 2 [14] - Rock solid macOS terminal JetBrains IDEs [15] - Cross platform suite of IDEs Rocket [16] -
Read the rest
macOS emoji quick substitution tool Transmit [17] - macOS SFTP/FTP/S3/etc tool VLC [18] - Cross platform video player CarbonCopyCloner [19] - macOS disk cloning/backup tool Pixelmator Pro [20] - macOS photo editor Preview [21] - Built-in macOS image/pdf viewer QuickLook [22] - Built-in macOS file preview tool [0] https://prologue.audio/ [1] https://overcast.fm/ [2] https://cleanshot.com/ [3] https://getdrafts.com/ [4] https://www.paprikaapp.com/ [5] https://www.youneedabudget.com/ [6] https://1password.com/ [7] https://www.meetcarrot.com/weather/ [8] https://colorslurp.com/ [9] https://github.com/kasper/phoenix [10] https://www.alfredapp.com/ [11] https://www.macbartender.com/ [12] https://coderunnerapp.com/ [13] https://daisydiskapp.com/ [14] https://iterm2.com/ [15] https://www.jetbrains.com/ [16] https://matthewpalmer.net/rocket/ [17] https://panic.com/transmit/ [18] https://www.videolan.org/vlc/ [19] https://bombich.com/ [20] https://www.pixelmator.com/pro/ [21] https://en.wikipedia.org/wiki/Preview_(macOS) [22] https://en.wikipedia.org/wiki/Quick_Look
In Ask HN: What software sparks joy when using?
My personal favorite app/software in this space is Phoenix [0]. It's more of a "build your own tiling/window manager" but I find it enjoyable to work with. I have my config written in TS and then I just run `tsc` to compile to JS which it uses. I have one hotkey I hit to put all my windows where I want them (aware of which setup I'm plugged into, home, laptop-only, remote office) on various monitors and then I have hotkeys to arrange/resize/move my windows around. The best part is if there is something I want to do I can just add it (add a modifier or a new hotkey combo). After having that freedom it's hard to consider using anything off-the-shelf even though many of them are quite good from what I can tell. [0] https://github.com/kasper/phoenix
In Yabai – A tiling window manager for macOS
Have you heard of Phoenix [1]? It seems relatively unknown but I actually found it to work better than Yabai in some ways. The gist is that it basically simulates a tiling wm and virtual desktops by internally tracking state. This also means it doesn't suffer from window animation delays when you switch "desktops" (since "desktops" are just hiding/unhiding windows). It's also highly hackable/extensible being written in JS. Spin2Win [2] is a config that's worked well for me. [1] https://github.com/kasper/phoenix [2] https://github.com/nik3daz/spin2win That said, it seems there are no perfect solutions. At work where I can't really be futzing around with window management config I basically just use Raycast + hotkeys and try to keep everything inside maximized application windows. This means using Arc browser (tabbed), iTerm (tabbed), VS Co
Read the rest
de (with native tabs), etc mapped to cmd+1, cmd+2, cmd+3...Not much "tiling" going on but at least everything is pretty keyboard friendly.
In Yabai – A tiling window manager for macOS
When I was annoyed with this I went ahead and downloaded phoenix (https://github.com/kasper/phoenix) wrote a little javascript and now I have a bunch of globally accessable hotkeys so I can lay my windows out in a number of combinations. Right now I have setups for over/under left/right, two by two grid, and three by three grid. I've got some plans to spend some time enabling more arbitrary grids and subgrids but I haven't gotten to it yet.
In Ask HN: Why does Apple refuse to add window snapping to macOS?
displayplacer is an awesome tool that I've mentioned on HN a number of times before. I have my displayplacer command setup to be run by Alfred so that when I connect my monitors I can just invoke Alfred, type "disp", and hit enter. The next step would be to have it auto-run when monitors were attached but this works well enough for me. displayplacer for monitor alignment, phoenix for window management, and my own hacked together mousejump for jumping over the monitor gaps make for an awesome experience. [0] https://github.com/kasper/phoenix [1] https://github.com/joshstrange/mousejump
In macOS CLI tool to configure multi-display resolutions and arrangements
Actually, if you're interested at all, I just, after literally months of reading about this, found a pretty sick solution. Have you ever heard of Phoenix? https://github.com/kasper/phoenix/. Despite googling around for this exact topic, with 3.8k stars I had never heard of it. Apparently someone has created slim, JS scriptable interface that is basically tailor made toward creating your own tiling WM. I just installed it and loaded one of the examples: https://github.com/nik3daz/spin2win. And what it does is basically ignores the built-in spaces and creates truly virtual desktops by just hiding and resizing windows. And it works pretty well. The response time between switching "desktops" is basically instant.
In Hyprland: A dynamic tiling Wayland compositor
I like that the author points out a number of great default shortcuts in macOS, but I find it hard to beat the combination of yabai[1] and skhd[2] for the best keyboard-driven workflow. In the absence of these, I would be more inclined to try either Hammerspoon or Karabiner-Elements. I also find Phoenix[3] intriguing, but it's probably too much work to get it to where I'd want it for daily use. [1] https://github.com/koekeishiya/yabai [2] https://github.com/koekeishiya/skhd [3] https://github.com/kasper/phoenix
In My macOS keyboard shortcuts
I've been using Phoenix (https://github.com/kasper/phoenix), which is hackable in JavaScript (here's my config: https://gist.github.com/rcarmo/5132874cdaf2755e42907508802e8...) and has a smaller scope (only window management), but haven't found it compelling enough to keep hacking at my config, so I'm back to Moom (https://manytricks.com/moom/), which would be perfect if it supported chaining sequences of sizing instructions (i.e., tile a window twice to the left to turn it from 1/2 to 1/3 width).
In Hammerspoon – Lua-based powerful tool automation of macOS

Showing the 15 most recent of 37 sources. Enable JavaScript to search and browse every indexed mention.

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.