mandragora

Use when adding, changing, looking up, or auditing keybindings/hotkeys/shortcuts across the mandragora repo. Loads the cross-program inventory and the user's existing binding "language" (modifier conventions, key families, shared prefixes) before proposing changes. Triggers on "bind X to Y", "what does <key> do", "find a free key for Z", conflict checks, hotkey audits, or any edit to hyprland/aerc/nvim/zsh/tmux/yazi/mpv/waybar bindings.

Use when about to launch any GPU/CUDA/PyTorch/Ollama workload, when wrapping a program that uses an LLM or image generator, when handling GPU coordination on Mandragora, or when working with the bots (im-gen, llm-via-telegram, crush, MCP server). Loads the full Mandragora gpu-lock contract — non-blocking respect-the-holder protocol, CLI verbs, library API, VRAM cleanup discipline, hard rules.

Use when the user wants to pass current task context to another AI agent (Gemini, Qwen, etc.) so they can continue mid-thought. Writes a structured baton-pass to ~/.ai-shared/handoffs/. Triggered explicitly via /handoff [to].

Use when /etc/nixos/mandragora has uncommitted changes that span multiple unrelated topics and the user wants each topic committed separately. Walks the diff, groups hunks by concern, and commits each group as its own commit.

Use when the user wants to refresh Open Notebook (nb.mvr.ac) with the current state of the mandragora-desktop obsidian vault. Runs the `nb-vault-sync` CLI, which idempotently diffs `~/Documents/mandragora-desktop-obsidian-vault/` against the `vault` notebook in Open Notebook and POST/DELETEs sources to match. Manual trigger only — never auto-run on edits, never embed (LLM cost) unless the user asks. Trigger phrases: "sync vault to nb", "refresh open-notebook", "update notebook from vault", "/nb-sync".

Use when the user wants to resume work from a handoff written by another agent. Reads the latest open handoff addressed to Claude from ~/.ai-shared/handoffs/ and continues from there. Triggered explicitly via /pickup.