explaingit

fieldju/amethyst

Analysis updated 2026-07-17 · repo last pushed 2021-07-29

Audience · developerComplexity · 2/5DormantLicenseSetup · easy

TLDR

A macOS window manager that automatically arranges your open windows into tidy layouts, controlled entirely through keyboard shortcuts.

Mindmap

mindmap
  root((repo))
    What it does
      Auto-arranges windows
      Keyboard-only control
      Multiple layout modes
      Multi-monitor support
    Tech stack
      macOS
      Swift
      Accessibility API
    Use cases
      Side-by-side coding
      Multi-monitor workflows
      Fast window switching
    Audience
      Developers
      Power users
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically snap windows into Tall, Wide, or Column layouts.

USE CASE 2

Manage windows across multiple monitors without touching a mouse.

USE CASE 3

Switch layouts and move focus between windows using keyboard shortcuts.

What is it built with?

SwiftmacOS

How does it compare?

fieldju/amethyst0verflowme/alarm-clock0xhassaan/nn-from-scratch
Stars0
LanguageCSSPython
Last pushed2021-07-292022-10-03
MaintenanceDormantDormant
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires granting accessibility permissions in macOS settings.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Amethyst is a window manager for macOS that automatically organizes your open windows into neat, non-overlapping layouts. Instead of manually dragging and resizing windows around your screen, you control window positions entirely through keyboard shortcuts. It's inspired by xmonad, a similar tool popular on Linux. The core idea is that your screen is divided into sections, and windows snap into those sections automatically. For example, the default "Tall" layout puts one main window on the left side of your screen at full height, and stacks all other windows on the right side. If you want a different arrangement, you can press a keyboard shortcut to switch to a different layout, like "Wide" (which flips the main area to the top), "Fullscreen" (one window takes over), or "Column" (each window gets its own vertical slice). You can also adjust how much space the main window takes up, move your focus between windows, or shuffle windows between different spaces and monitors, all without touching your mouse. Power users, developers, and anyone who spends hours at their computer benefit most from this. If you regularly switch between many applications, keep multiple documents open side-by-side, or work across multiple monitors, Amethyst saves you constant window-shuffling. It works well for coding (browser on one side, editor on the other), writing, design, or research work where you're juggling many windows at once. To use Amethyst, you install it via Homebrew or download it directly, then grant it permission to control your windows through macOS's accessibility settings. All window management happens through keyboard combinations like Option+Shift or Control+Option+Shift plus a letter key, there's no menu to click. The README includes a full list of shortcuts and describes all ten available layouts, so you can pick whichever ones suit your workflow best.

Copy-paste prompts

Prompt 1
Help me install Amethyst via Homebrew and grant it accessibility permissions on macOS.
Prompt 2
Explain the difference between Amethyst's Tall, Wide, and Column layouts.
Prompt 3
Show me the default keyboard shortcuts for moving and resizing windows in Amethyst.
Prompt 4
Suggest an Amethyst layout setup for coding with a browser and editor side by side.

Frequently asked questions

What is amethyst?

A macOS window manager that automatically arranges your open windows into tidy layouts, controlled entirely through keyboard shortcuts.

Is amethyst actively maintained?

Dormant — no commits in 2+ years (last push 2021-07-29).

What license does amethyst use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is amethyst to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is amethyst for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.