Gemini CLI Custom Commands Pack: 21 TOML Commands + Validator

21 ready-to-use custom slash commands for Gemini CLI (/git:commit, /review:diff, /test:fix, /plan:feature...) plus gcmd.py, a validator, previewer, installer and Claude Code converter for .gemini/commands/*.toml files.

python3 tools/gcmd.py install /path/to/project --dry-run     # see what goes where
python3 tools/gcmd.py install /path/to/project               # -> .gemini/commands/ (never overwrites without --force)
python3 tools/gcmd.py install --user --only git,review       # -> ~/.gemini/commands/ for every project

Then in Gemini CLI: /commands reload and type / to see them. Or just copy the commands/ folder contents into .gemini/commands/.

Every !{...} shell command in the pack is read-only (git log/diff, ls, cat, git grep); Gemini CLI still asks you to confirm each one.

python3 tools/gcmd.py validate .gemini/commands ~/.gemini/commands   # --strict also fails on warnings (CI)
python3 tools/gcmd.py render /git:pr --args "fixes login" --dir .gemini/commands   # exact prompt; add --run to execute !{...}
python3 tools/gcmd.py from-claude .claude/commands .gemini/commands --write          # port Claude Code commands

validate catches:

• TOML syntax errors, missing prompt, unknown keys (promt), multi-line descriptions
• unbalanced braces in !{...} / @{...} (Gemini CLI cannot parse these)
• {{args}} inside @{...}: file injection runs before argument substitution, so the path is never filled in
• "{{args}}" quoted inside !{...}: Gemini already shell-escapes it there, so you get stray quotes
• shell commands that push, delete, reset, sudo, pipe curl | sh or write files with >
• names that clash with built-ins (/help, /memory, /plan...)
• the same command in project and user folders (the project one wins)

from-claude maps $ARGUMENTS (and $1..$9) to {{args}}, !cmd to !{cmd}, @file to @{file}, the frontmatter description to description, and subfolders to namespaces. It tells you what it dropped (allowed-tools, model).

• Project commands live in .gemini/commands/, user commands in ~/.gemini/commands/. git/commit.toml becomes /git:commit.
• prompt (required) and description (optional, shown in /help).
• {{args}} is replaced with what you type after the command (shell-escaped inside !{...}). With no {{args}}, your text is appended to the prompt.
• !{cmd} runs a shell command after confirmation and inserts its output; @{path} inserts a file or folder. Order: @{} first, then !{}, then {{args}}.

commands/ (21 TOML), tools/gcmd.py, tools/demo.sh, examples/broken-commands (8 mistakes), examples/claude-commands (2 to convert), skills/gemini-commands/, tests/ (13 tests).

• The commands are prompts: results depend on the model and your repo. They assume git and a POSIX shell (/git:pr expects origin/HEAD to be set: git remote set-head origin -a).
• render approximates Gemini CLI's expansion offline; Gemini CLI itself is the source of truth. On Python 3.9/3.10 a built-in parser handles the TOML subset command files use.
• Not affiliated with Google.