{
  "markdown": "# Gemini Subagent Wizard\n\n**An interactive TUI for creating and managing specialist subagents in the Gemini CLI.**\n\nInspired by the subagent creation experience in Claude, this tool brings the same concept to the **Gemini CLI** — letting you spin up specialist agents with a guided workflow instead of hand-editing config files.\n\nWriting YAML frontmatter by hand is error-prone. The **Gemini Subagent Wizard** provides a beautiful, interactive TUI to draft complex agent personas using Gemini itself, select whitelisted tools, and save them exactly where the Gemini CLI expects to find them.\n\n## Key Features\n\n* **AI-Powered Drafting:** Tell the wizard what you need, and it uses Gemini to write a professional system prompt for your subagent.\n* **Safety Check:** Automatically verifies your `settings.json` to ensure experimental agents are enabled.\n* **Strict Tool Mapping:** Only allows officially whitelisted Gemini CLI tools (`read_file`, `grep_search`, `run_shell_command`, etc.) to prevent validation crashes.\n* **Responsive Previews:** See exactly what your `.md` agent file looks like before saving.\n* **Dual-Scope Support:** Save agents to your local project (`.gemini/agents/`) or your global user profile (`~/.gemini/agents/`).\n\n---\n\n## Install the extension\n\n```bash\ngit clone https://github.com/he-jiaxin/gemini-subagent-wizard.git\n```\n\n## Quickstart: create your first subagent\n\n\n### 1. Open the wizard\n\nInside any Gemini CLI session, run:\n\n```\n/subagent:create\n```\n\n### 2. Choose a scope\n\nSelect **Project-level** to save the agent to `.gemini/agents/` in your current repo, or **User-level** to save it to `~/.gemini/agents/` so it's available across all your projects.\n\n### 3. Choose a creation method\n\nSelect **Generate with Gemini** to have Gemini draft the agent for you. When prompted, describe what you need:\n\n```\nA security auditor that reviews code for vulnerabilities, explains each\nissue with the affected lines, and suggests a safe fix.\n```\n\nGemini generates the agent name, description, and system prompt for you.\n\nPrefer full control? Select **Manual configuration** to type the name, description, and system prompt yourself.\n\n### 4. Select tools\n\nChoose which tools the agent can use:\n\n| Option | Tools included |\n|---|---|\n| All tools | `read_file`, `glob`, `grep_search`, `write_file`, `run_shell_command`, `google_web_search` |\n| Read-only | `read_file`, `glob`, `grep_search` |\n| Edit | `write_file` |\n| Execution | `run_shell_command` |\n| Other | `google_web_search` |\n| Advanced | Pick individual tools from the full list |\n\nFor a read-only reviewer, select **Read-only tools** only. If you select nothing, the agent inherits all tools from the main conversation.\n\n### 5. Select a model\n\nChoose which model the agent runs on:\n\n- **Inherit** — uses whatever model the main conversation is using\n- **Gemini 2.5 Flash** — fast, great for straightforward tasks\n- **Gemini 2.5 Pro** — more capable, better for complex analysis\n\n### 6. Review and save\n\nThe wizard shows a full preview of the `.md` file before writing anything:\n\n```\n---\nname: security-auditor\ndescription: Use this agent to review code for security vulnerabilities.\nmodel: gemini-2.5-pro\ntools:\n  - read_file\n  - glob\n  - grep_search\n---\n\nYou are an expert security engineer...\n```\n\nSelect **Save and create agent** to write the file, or **Discard** to exit without saving.\n\n### 7. Load the agent\n\nRun `/agents refresh` in your Gemini CLI session to load the new agent immediately. Then try it:\n\n```\nUse the security-auditor agent to review the auth module for vulnerabilities.\n```\n\nGemini delegates to your new subagent, which scans the files and returns its findings.\n\nYou now have a reusable specialist agent scoped exactly where you need it.\n\n\nThe wizard will launch and walk you through creating your subagent. After saving, run `/agents refresh` to load it immediately.\n\n---\n\n\n## How It Works\n\nThe extension registers a `create` command that the AI can invoke. The `GEMINI.md` context file also lets Gemini proactively suggest the wizard whenever you mention creating a specialist or setting up a subagent.\n\n---\n\n## Prerequisites\n\n* **Gemini CLI** installed and authenticated\n* **Subagents Enabled:** Ensure your `~/.gemini/settings.json` contains:\n    ```json\n    \"experimental\": {\n      \"enableAgents\": true\n    }\n    ```\n  The wizard will warn you if this isn't set.\n\n---\n\n## Development\n\nTo build from source:\n\n```bash\nnpm install\nnpm run build\ngemini extensions link .\n```\n\nRun directly without building:\n\n```bash\nnpm run dev\n```\n\n## License\nISC © 2026\n",
  "bytes": 4562,
  "sha": "de3946a289b828df7eb155b40899b8cc797cba27ef9197a625703e076e0ca134",
  "repo_slug": "he-jiaxin/gemini-subagent-wizard",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_he_jiaxin_gemini_subagent_wizard_f78d948d/readme"
}