David Heinemeier HanssonandClaude Fable 5
1ae83f1606
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>
50 lines
2.6 KiB
Markdown
50 lines
2.6 KiB
Markdown
# 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).
|