Hello world

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

docs/custom-commands.md

@@ -0,0 +1,50 @@
+# Custom commands
+
+Run your own shell commands on the selected item, like lazygit's custom
+commands: by their key in the pane they're for, or from the commands menu
+(`x`, also listed under `?`).
+
+```yaml
+customCommands:
+  - key: K
+    context: secrets               # sources | vaults | secrets | global
+    description: Create Kubernetes secret
+    command: kubectl create secret generic {{.Name}} -n {{.Prompt.ns}} --from-file=value=/dev/stdin
+    value: stdin                   # the value on the command's input; or env:NAME
+    prompts:
+      - {name: ns, title: Namespace, default: default}
+    output: popup                  # quiet (default) | popup | terminal
+  - key: E
+    context: secrets
+    description: Add to .env
+    command: printf '%s=%s\n' {{.Name}} "$(cat)" >> .env
+    value: stdin
+  - context: vaults
+    description: Show in az
+    command: az keyvault show --name {{.Vault}}
+    output: terminal
+```
+
+## Fields
+
+`.Kind`, `.Account`, `.Source`, `.SourceID` (subscription ID or Databricks
+profile), `.Vault`, `.VaultURL`, `.Name`, `.Type`, `.Version` (from the
+versions view), `.Link`, `.Reference`, `.URL` (web page), `.Note`,
+`.Expires`, and `.Prompt.<name>`. They're shell-quoted when filled in, so a
+note can't break or inject into the command; `{{raw .Note}}` opts out.
+
+## The value
+
+The secret value is never a field, so it can't end up on a command line
+(where `ps` and shell history see it). `value: stdin` hands it to the
+command's input, `value: env:NAME` puts it in that environment variable for
+the command alone; without `value` it isn't fetched. Commands that get the
+value ask first, showing the command (`confirm: false` skips that).
+
+## Running
+
+Output: `quiet` runs in the background with ✓ or ✗ in the footer, `popup`
+shows what it printed, `terminal` hands it the terminal and waits for
+enter. Commands run with `$SHELL -c` in the directory lazysecrets started
+in, and come only from your config: a link can never run one. Their keys
+are checked against the [keybindings](keys.md#rebinding-keys) at startup.