From 1f4bd3d5faca6a95c40198b5fb7416a136ec3478 Mon Sep 17 00:00:00 2001 From: Bernardo Magri Date: Tue, 16 Jun 2026 17:48:22 +0100 Subject: [PATCH] =?UTF-8?q?docs(readme):=20document=20the=20curated=20shel?= =?UTF-8?q?l=20aliases=20in=20=C2=A75=20Day-to-day?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit List the on-by-default zsh aliases (navigation, git, nix, misc) in the Day-to-day section so they're discoverable from the README, not just by running `alias`. Note the doc location in the roadmap item. Co-Authored-By: Claude Opus 4.8 --- README.md | 26 ++++++++++++++++++++++++++ docs/ROADMAP.md | 3 ++- 2 files changed, 28 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0f43b86..9457d87 100644 --- a/README.md +++ b/README.md @@ -296,6 +296,32 @@ picker · `SUPER+SHIFT+T` next wallpaper · `SUPER+X` power menu · clipboard history · `SUPER+Q` close · `SUPER+1..9` workspaces · `Print` region screenshot. +Shell aliases (zsh, gated on `nomarchy.shell.enable`) — `alias` lists them +all; the curated set: + +```sh +# navigation +.. ... .... # cd up 1 / 2 / 3 levels + +# git +g gst # git · git status -sb +ga gaa # git add · git add -A +gc gcm # git commit · git commit -m +gco gsw gb # checkout · switch · branch +gd gds # diff · diff --staged +gl glg # log graph (last 20 · all branches) +gp gpl gf # push · pull · fetch --all --prune + +# nix (system/home rebuilds keep their full sys-update / home-update names) +ns nr # nix shell · nix run (e.g. ns nixpkgs#ripgrep) +nfu nfc # nix flake update · check +nsearch ngc # nix search nixpkgs · nix-collect-garbage -d + +# misc +path # print $PATH, one entry per line +reload # exec zsh (reload the shell) +``` + ## 6. Extending - **New theme:** drop a JSON into `themes/` (schema = any existing preset), diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 19f954d..a3e04b7 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -120,7 +120,8 @@ how to override it. Items marked ✓ are shipped. `nsearch`, `ngc`), plus `path` and `reload`. Scope decision: short where it helps but **never shadow a real binary** (same rule as rg/fd — the git block deliberately avoids `gs`/ghostscript); system/home rebuilds keep their full - `sys-update`/`home-update` names rather than getting cryptic aliases. + `sys-update`/`home-update` names rather than getting cryptic aliases. The set + is documented in README §5 (Day-to-day), and `alias` lists them in-shell. - **Theme-switch feedback:** ✓ the "rebuilding…" notification is now persistent (timeout 0) and replaced in place by "applied ✓" / failure via a synchronous tag, so a multi-minute switch never reads as a failed