Files

T

David Heinemeier HanssonandClaude Fable 5 1ae83f1606 Add a switchers chapter and fix drift found on a second manual pass

Add "Coming From Mac or Windows" as chapter 3: a translation layer for
Cmd/Win instincts rather than a feature tour.

Fill the remaining coverage gaps: fcitx5 input methods, laptop speaker
tuning, touchpad haptics, crash capture in the toggle table, the
installable font list, and the ChatGPT Desktop and Grok Bot entries.

Correct claims that drifted from the source: the network and bluetooth
bar icons no longer launch nmtui/bluetoothctl, monitor scaling steps
rather than cycles, and the display widget's scroll steps brightness.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-08-13 22:52:13 +02:00

2.6 KiB

Raw Permalink Blame History

Shell Functions

Omarchy comes with a set of shell functions to simplify common tasks and encapsulate convoluted parameter calls.

Compression

compress [file/dir]: Create a tar.gz archive from the file/dir.
decompress [file.tar.gz]: Expand a tar.gz file.

Drives

iso2sd [image.iso]: Create a bootable drive on an SD card using the referenced iso file and picking the drive interactively.
format-drive [device] [name]: Format an entire disk with a single exFAT partition (which works on Windows and macOS too). Run it without arguments to see the available drives. Be careful!

Dev layouts

Instant multi-pane development layouts for tmux:

tdl [ai]: Create a Tmux Dev Layout with your editor, an AI agent, and a terminal. Use the agent aliases, like tdl c for opencode or tdl cx for Claude Code, or pass a second agent to run both, like tdl c cx.
tds: Create a Tmux Dev Square with editor, diff watching (via hunk diff --watch), terminal, and opencode.
tdlm [ai]: Create a tdl window for every subdirectory in the current directory.
tsl [count] [command]: Create a swarm of panes tiled in a grid, all running the same command (great for AI agents).

The same layouts are available for Herdr as hdl, hds, hdlm, and hsl.

Git worktrees

ga [branch]: Create a new worktree and branch next to the current repository and jump into it.
gd: Remove the current worktree and its branch (asks for confirmation first).

Rsync watchers

rsw [source] [destination]: Start a background watcher that rsyncs source to destination whenever anything changes. The destination can be a remote host, like rsw ~/Work/app nyc-dev:Work/app.
lsw: List all active watchers.
dsw: Stop all active watchers.

SSH Portforwarding

Ideal for doing web development with localhost secure-context privileges against a remote box.

fip: Forward one or more ports from a remote host to localhost via SSH.
dip: Disconnect one or more forwarded ports.
lip: List all active SSH port forwards.

Say you start a dev server on port 3000 on a machine accessible as nyc-dev, then you can run fip nyc-dev 3000 to forward that port, so localhost:3000 actually reaches nyc-dev:3000, but without the need for SSL certificates to establish the secure context needed for testing web sockets or the like.

SSH reconnection

ssh itself is wrapped in a function that cleans up the terminal if a connection dies while a remote tmux, Herdr, or editor has claimed it, and then automatically reconnects when an interactive session drops (Ctrl-C stops the retry loop).

2.6 KiB Raw Permalink Blame History