WHERE_ARE_AGENTS.md
1 # 🎯 WHERE TO FIND AGENTS IN KAMAJI TUI 2 3 ## Step-by-Step Visual Guide 4 5 ### 1. Launch the TUI 6 7 ```bash 8 cd /Users/joshkornreich/Documents/Projects/kamaji 9 ./kamaji/kamaji tui 10 ``` 11 12 --- 13 14 ## 🔍 WHERE TO LOOK 15 16 ### LEFT SIDE OF SCREEN (Sidebar) 17 18 When TUI opens, look at the **LEFT PANEL**. You should see: 19 20 ``` 21 ╭─────────────────────────╮ 22 │ 🎭 KAMAJI AI │ ← Top of sidebar 23 │ │ 24 │ 📁 Working Dir │ 25 │ /path/to/project │ 26 │ │ 27 │ 🤖 Specialized Agents │ ← AGENTS SECTION HERE! 28 │ 🏗️ Code Architect │ ← Agent 1 29 │ 🛡️ Security │ ← Agent 2 30 │ 📊 Data Scientist │ ← Agent 3 31 │ ⚙️ DevOps │ ← Agent 4 32 │ 🎨 Designer │ ← Agent 5 33 │ 📱 Product Mgr │ ← Agent 6 34 │ 🔬 Researcher │ ← Agent 7 35 │ 📚 Learning │ ← Agent 8 36 │ 🔮 Visionary │ ← Agent 9 37 │ Press ^A to select │ ← Hint text 38 │ │ 39 │ 🧭 Navigation │ 40 │ furnace commands ^P │ 41 │ tools ^T │ 42 │ agents ^A │ ← This opens full selector 43 │ mcp ^M │ 44 │ exit boiler ^C │ 45 ╰─────────────────────────╯ 46 ``` 47 48 **The agents are in the section marked "🤖 Specialized Agents"** 49 50 --- 51 52 ### PRESS Ctrl+A (Full Agent Selector) 53 54 Press the `Ctrl` key + `A` key together. 55 56 A **full-screen overlay** should appear: 57 58 ``` 59 ┌────────────────────────────────────────────────────────────┐ 60 │ │ 61 │ 🤖 SELECT SPECIALIZED AGENT │ 62 │ │ 63 │ ↑/↓ navigate • Enter select • Esc cancel │ 64 │ │ 65 │ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ │ 66 │ ┃ 🏗️ Code Architect [EXPERT] ┃ │ 67 │ ┃ ID: architect-001 • Type: architect ┃ │ 68 │ ┃ ┃ │ 69 │ ┃ 💭 "The Architect" - systematic design... ┃ │ 70 │ ┃ ┃ │ 71 │ ┃ ✨ analytical • systematic • visionary ┃ │ 72 │ ┃ 🎯 system design, architecture patterns ┃ │ 73 │ ┃ 🔧 3 capabilities ┃ │ 74 │ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ │ 75 │ │ 76 │ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ │ 77 │ ┃ 🛡️ Security Specialist [EXPERT] ┃ │ 78 │ ┃ ... ┃ │ 79 │ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ │ 80 │ │ 81 │ ... 7 more agents below ... │ 82 │ │ 83 └────────────────────────────────────────────────────────────┘ 84 ``` 85 86 --- 87 88 ## 🚨 If You DON'T See Agents 89 90 ### Check 1: Is the sidebar visible? 91 The sidebar should be on the **LEFT** side, about 30 characters wide. 92 93 If you don't see it: 94 - Terminal might be too narrow 95 - Try making terminal window wider 96 97 ### Check 2: Scroll down in sidebar 98 If terminal is short, you might need to see more of the sidebar content. 99 100 ### Check 3: Is this the right TUI? 101 Make sure you're running: 102 ```bash 103 ./kamaji/kamaji tui 104 ``` 105 106 NOT: 107 - `kamaji tui` (wrong path) 108 - Python version 109 110 ### Check 4: Build was successful? 111 ```bash 112 cd go 113 go build -o ../kamaji/kamaji ./cmd/kamaji 114 # Should show no errors 115 ``` 116 117 --- 118 119 ## 📸 What You Should See 120 121 ### Screen Layout: 122 123 ``` 124 ┌─────────────┬──────────────────────────────────────────────┐ 125 │ │ │ 126 │ SIDEBAR │ MAIN CHAT AREA │ 127 │ (LEFT) │ │ 128 │ │ Messages appear here │ 129 │ Agents │ │ 130 │ listed │ │ 131 │ here! │ │ 132 │ │ │ 133 │ │ │ 134 │ │ ────────────────────────────────────────── │ 135 │ │ 🔥 Speak to the furnace spirit... │ 136 │ │ Type here ▊ │ 137 │ │ │ 138 └─────────────┴──────────────────────────────────────────────┘ 139 Status: v1.0.9 | Q | Ready 140 [^P] commands • [^T] tools • [^A] agents • [^C] quit 141 ``` 142 143 **Agents are in the LEFT section (sidebar)** 144 145 --- 146 147 ## 🎮 Quick Test 148 149 1. Run: `./kamaji/kamaji tui` 150 2. Look LEFT 151 3. Find "🤖 Specialized Agents" heading 152 4. See 9 agents listed below it 153 5. Press Ctrl+A 154 6. See full agent selector overlay 155 156 --- 157 158 ## 💡 If Still Not Visible 159 160 Let me know what you see instead and I'll help troubleshoot: 161 - Is there a sidebar at all? 162 - What does the left side show? 163 - Does Ctrl+A do anything? 164 - What's your terminal size? (run: `echo $COLUMNS x $LINES`) 165 166 The agents ARE there - let's figure out why you're not seeing them!