1  # ✨ Kamaji Agents - Quick Start Guide
  2  
  3  ## 🚀 Launch Kamaji TUI
  4  
  5  ```bash
  6  cd /Users/joshkornreich/Documents/Projects/kamaji
  7  ./kamaji/kamaji tui
  8  ```
  9  
 10  ## 🤖 Access Agents
 11  
 12  Press **`Ctrl+A`** to open the agent selector
 13  
 14  You'll see a beautiful interface showing all 9 specialized agents:
 15  
 16  ```
 17  🤖 SELECT SPECIALIZED AGENT
 18  
 19  ↑/↓ navigate  •  Enter select  •  Esc cancel  •  1-5 filter by level
 20  
 21  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
 22  ┃ 🏗️ Code Architect          [EXPERT]        ┃
 23  ┃ 💭 "The Architect" - systematic design     ┃
 24  ┃ ✨ analytical • systematic • visionary      ┃
 25  ┃ 🎯 system design, architecture patterns    ┃
 26  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 27  
 28  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
 29  ┃ 🛡️ Security Specialist     [EXPERT]        ┃
 30  ┃ 💭 "The Guardian" - security-first         ┃
 31  ┃ ✨ vigilant • thorough • methodical         ┃
 32  ┃ 🎯 vulnerability assessment, secure coding  ┃
 33  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 34  
 35  ...and 7 more!
 36  ```
 37  
 38  ## 📝 Use an Agent
 39  
 40  1. **Navigate** with ↑/↓ or k/j keys
 41  2. **Select** agent with Enter
 42  3. **Type** your request
 43  4. Agent uses its specialized knowledge and tools
 44  
 45  ## 🎯 Example Workflows
 46  
 47  ### Security Review
 48  ```
 49  1. Ctrl+A
 50  2. Select "🛡️ Security Specialist"
 51  3. Type: "Review authentication.go for vulnerabilities"
 52  4. Agent uses grep, view, and sourcegraph tools
 53  ```
 54  
 55  ### Architecture Design
 56  ```
 57  1. Ctrl+A
 58  2. Select "🏗️ Code Architect"  
 59  3. Type: "Design a microservices architecture for our API"
 60  4. Agent applies architecture patterns
 61  ```
 62  
 63  ### Container Setup
 64  ```
 65  1. Ctrl+A
 66  2. Select "⚙️ DevOps Engineer"
 67  3. Type: "Set up Docker containers for our app"
 68  4. Agent uses container tool
 69  ```
 70  
 71  ## 🎨 Agent Levels
 72  
 73  **Look for the colored badges:**
 74  - 🟡 **AUTONOMOUS** - Self-improving, strategic thinking
 75  - 🔴 **EXPERT** - Deep domain expertise
 76  - 🟣 **ADVANCED** - Complex problem solving
 77  
 78  ## 🔑 Hotkeys
 79  
 80  ```
 81  Ctrl+A  - Open agents
 82  Ctrl+P  - Command palette
 83  Ctrl+T  - Tools menu
 84  Ctrl+M  - MCP menu
 85  Ctrl+C  - Quit
 86  
 87  ↑/↓ or k/j - Navigate
 88  Enter      - Select
 89  Esc        - Cancel
 90  ```
 91  
 92  ## 📚 Full Documentation
 93  
 94  See `docs/AGENTS_GUIDE.md` for complete details on:
 95  - All 9 agents and their capabilities
 96  - Programmatic usage
 97  - Configuration options
 98  - Examples and tips
 99  
100  ---
101  
102  **Enjoy your specialized AI agents! 🚀**