Gemini CLI Installation Guide

Prerequisites

• Gemini CLI installed
• Network access to GitHub

Installation Steps

One-Command Install

gemini extensions install https://github.com/obra/superpowers

Verify Installation

Start a new session and ask:

What superpowers do you have?

If Gemini can list skills and explain how to use them, installation was successful.

Configuration File Locations

• Extension config: ~/.gemini/extensions/superpowers/
• Context file: ~/.gemini/extensions/superpowers/GEMINI.md

Updating

gemini extensions update superpowers

Tool Mapping

Superpowers skills use Claude Code tool names. Gemini CLI automatically maps them:

Skill Reference	Gemini CLI Equivalent
Read	read_file
Write	write_file
Edit	replace
Bash	run_shell_command
Grep	grep_search
Glob	glob
TodoWrite	write_todos
Skill	activate_skill
WebSearch	google_web_search
WebFetch	web_fetch

Subagent Limitation

Gemini CLI has no subagent capability (equivalent to Claude Code's Task tool). Skills that rely on subagents (subagent-driven-development, dispatching-parallel-agents) will fall back to single-session execution using executing-plans.

Gemini-Exclusive Tools

Gemini CLI has tools not available in Claude Code:

Tool	Purpose
list_directory	List files and subdirectories
save_memory	Persist facts to GEMINI.md across sessions
ask_user	Request structured input from user
tracker_create_task	Rich task management
enter_plan_mode / exit_plan_mode	Switch to read-only research mode

Troubleshooting

Skills not working after installation

Make sure you're in a new session. Gemini CLI needs to restart to load new extensions.

Extension installation fails

Check your network connection and ensure you can access GitHub. If using a proxy, configure the HTTP_PROXY environment variable.

Cannot use subagent skills

This is expected. Gemini CLI doesn't support subagents. Related skills automatically fall back to single-session execution.

Uninstalling

gemini extensions uninstall superpowers