{
  "markdown": "# Agent Creator Extension for Gemini CLI\n\nAn AI-powered extension for [Gemini CLI](https://github.com/google-gemini/gemini-cli) that makes creating custom agents effortless through natural conversation.\n\n## 🎯 What It Does\n\nThis extension provides the `/new-agent` command that guides you through creating custom agent definitions using AI-assisted conversation. Instead of manually writing TOML files or filling out forms, you simply chat with the AI about what you want to build.\n\n## ⚡ Quick Start\n\n### Installation\n\n1. **Clone this repository** into your Gemini extensions directory:\n   ```bash\n   git clone https://github.com/jduncan-rva/gemini-agent-creator.git ~/.gemini/extensions/agent-creator\n   ```\n\n2. **Restart Gemini CLI** to load the extension\n\n3. **Verify installation**:\n   ```bash\n   /extensions list\n   ```\n   You should see `agent-creator` in the list.\n\n### Usage\n\n#### Quick Mode (AI Expands Your Idea)\n\nProvide a brief description and let the AI flesh out a complete agent:\n\n```bash\n/new-agent \"reviews code for security vulnerabilities\"\n```\n\nThe AI will:\n1. Analyze your description\n2. Generate a comprehensive agent definition with smart defaults\n3. Show you the complete TOML configuration\n4. Ask for your approval before saving\n\n**Example descriptions:**\n- `\"reviews python code for bugs\"`\n- `\"generates API documentation\"`\n- `\"writes unit tests for functions\"`\n- `\"explains complex code in simple terms\"`\n- `\"finds performance bottlenecks\"`\n\n#### Interactive Mode (Guided Conversation)\n\nRun without arguments for step-by-step guidance:\n\n```bash\n/new-agent\n```\n\nThe AI will guide you through:\n1. Defining what your agent does\n2. Selecting which tools it needs\n3. Writing its behavior and instructions\n4. Defining input parameters\n5. Reviewing the generated configuration\n6. Saving to `~/.gemini/agents/`\n\n## 📝 Example Session\n\n### Quick Mode Example\n\n```\n> /new-agent \"analyzes code for performance issues\"\n\nGreat! I'll create a performance analysis agent for you.\n\nBased on your description, here's what I'm proposing:\n\n**Agent: performance_analyzer**\n- Display Name: ⚡ Performance Analyzer\n- Icon: ⚡\n- Tools: read, grep, glob\n- Purpose: Identifies performance bottlenecks and optimization opportunities\n\nHere's the complete configuration:\n\n```toml\nname = \"performance_analyzer\"\ndisplayName = \"⚡ Performance Analyzer\"\ndescription = \"Analyzes code for performance issues and suggests optimizations\"\nicon = \"⚡\"\n\ntools = [\"read\", \"grep\", \"glob\"]\n\nsystemPrompt = \"\"\"\nYou are a performance optimization expert...\n[detailed instructions]\n\"\"\"\n\nquery = \"Analyze ${file_path} for performance issues\"\n\n[inputs.file_path]\ntype = \"string\"\ndescription = \"Path to file or directory to analyze\"\nrequired = true\n```\n\nDoes this look good, or would you like to customize anything?\n\n> looks perfect!\n\n✅ Saving to ~/.gemini/agents/performance_analyzer.toml...\n🎉 Agent created successfully! Restart CLI to use it.\n```\n\n## 🛠️ Available Tools for Agents\n\nYour agent can use these read-only tools:\n- `ls` - List directories\n- `read` - Read files\n- `grep` - Search in files\n- `glob` - Find files by pattern\n- `read_many_files` - Read multiple files\n- `memory` - Persistent memory\n- `web_search` - Web search\n\n## 📚 Agent Templates\n\nThe assistant knows about common agent patterns:\n- **Code Reviewers** - Find bugs, security issues, style problems\n- **Documentation Generators** - Create docs from code\n- **Test Writers** - Generate test cases\n- **Research Assistants** - Gather information\n- **Code Explainers** - Explain complex code\n\n## 💡 Tips\n\n- Be specific about what you want the agent to do\n- Think about what files/data it needs to access\n- Consider what inputs make sense (file paths, questions, etc.)\n- The AI will suggest good defaults - feel free to customize\n\n## 🔧 Troubleshooting\n\n**Extension not found?**\n- Restart Gemini CLI to load the extension\n- Check that the extension is in `~/.gemini/extensions/agent-creator/`\n- Verify `gemini-extension.json` exists in the extension directory\n\n**Agent not working after creation?**\n- Restart CLI to load the new agent\n- Check the TOML file for syntax errors: `~/.gemini/agents/<name>.toml`\n- Use `/agents` to verify it loaded\n\n**Want to edit an agent?**\n- Edit the file directly: `~/.gemini/agents/<name>.toml`\n- Or delete and recreate with `/new-agent`\n\n## 📋 Requirements\n\n- [Gemini CLI](https://github.com/google-gemini/gemini-cli) with user-defined agents support\n- The agent system must be available (check for `~/.gemini/agents/` directory)\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details\n\n## 🙏 Credits\n\nCreated by [@jduncan-rva](https://github.com/jduncan-rva) with [Claude Code](https://claude.com/claude-code)\n\nBuilt for [Gemini CLI](https://github.com/google-gemini/gemini-cli) by the Google Gemini team\n\n## 🔗 Related\n\n- **Main Fork with Agent System**: [jduncan-rva/gemini-cli](https://github.com/jduncan-rva/gemini-cli/tree/feature/user-defined-agents)\n- **Gemini CLI**: [google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli)\n\n---\n\n**Note**: This extension requires the user-defined agents feature. See the [feature branch](https://github.com/jduncan-rva/gemini-cli/tree/feature/user-defined-agents) for installation.\n",
  "bytes": 5325,
  "sha": "8e5abbe4f814e02520c194a813484bad2445d5da35e2fdc220e5b3f22366938a",
  "repo_slug": "jduncan-rva/gemini-agent-creator",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_jduncan_rva_gemini_agent_creator_93b6d8f2/readme"
}