Use Spec Kitty in Google Gemini CLI

Tier: supported. Citation (accessed 2026-05-21): https://github.com/google-gemini/gemini-cli

Prerequisites

• Spec Kitty CLI installed. See Install Spec Kitty.
• Project initialized for this harness:

  spec-kitty init --ai gemini
  

• Gemini CLI installed and authenticated. Follow the google-gemini/gemini-cli README for installation and login.

Where Spec Kitty installs files

Per the supported-harnesses matrix, Gemini CLI uses the slash-command mechanism. Spec Kitty installs:

• Directory: .gemini/commands/
• Files: spec-kitty.specify.md, spec-kitty.plan.md, spec-kitty.tasks.md, spec-kitty.implement.md, spec-kitty.review.md, spec-kitty.accept.md, spec-kitty.merge.md, spec-kitty.dashboard.md, spec-kitty.status.md, spec-kitty.charter.md, spec-kitty.analyze.md, spec-kitty.research.md.

Canonical invocation

Inside the Gemini CLI, slash commands are invoked as:

/spec-kitty.specify "<one-line mission description>"
/spec-kitty.plan
/spec-kitty.tasks
/spec-kitty.implement WP01

Worked example

1. From your project root, launch Gemini CLI (gemini).
2. At the prompt, type:

   /spec-kitty.specify "a hello world page"
   

3. Spec Kitty's interview prompts appear — answer them inline.
4. When asked for a kebab-case slug, supply something short, e.g. hello-world-page.
5. The mission spec lands at kitty-specs/hello-world-page-<mid8>/spec.md.

Troubleshooting

• /spec-kitty.* commands do not appear. Run spec-kitty agent config sync from the repo root. This rewrites .gemini/commands/ from the canonical source templates. Restart Gemini CLI.

• Profile not loading. Run inside Gemini CLI:

  /ad-hoc-profile-load researcher-robbie
  

  Use the profile id from the work-package frontmatter.

Where to learn more about Gemini CLI

Authoritative documentation: https://github.com/google-gemini/gemini-cli (accessed 2026-05-21).