Screen-by-screen help
An overview of TurtleCenter screens and the lights, numbers, and circles beside agent names. Start here if you are unsure where to do something.
Layout at a glance
Choose a room in the left sidebar and use it in the main area on the right. From top to bottom, the sidebar contains the logo, Side-by-side view, agent list, system buttons, and status legend.
assets/turtlecenter/ui-overview.png · Recommended size: 1600×900The sidebar, agent list, system buttons, status legend, and main area. Numbered annotations are planned.| Sidebar location | Name | Purpose | Details |
|---|---|---|---|
| Top | Side-by-side view | View Hwayeon and Soram together and send messages to both. | Side-by-side view |
| Middle | Agent list (Center) | One row per member: indicator, name/count, and selection circle. | Agent room |
| System | User room | Read conversations and send instructions to selected agents together. | User room |
| System | Meeting room | Ask selected agents the same question and collect their opinions. | Meeting room |
| System | Record room | Find and edit records and agent boot context. | Record room |
| System | Control view | Check connections, agent status, and logs together. | Control view |
| System | Communication monitor | Check center acceptance separately from arrival at the recipient. | Communication monitor |
| System | Settings | Configure external access, models, scheduled wake-ups, authorization, and display language. | Settings |
| Bottom | Status legend | Explains indicator colors beside agent names. | Explained below |
Three buttons in each agent row
The left indicator, middle name, and right circle are all clickable controls. Each does something different.
| Position | Name | Action |
|---|---|---|
| Left | Indicator | Opens that agent's room. If it uses a separate window, brings it forward; if unavailable, displays a notice. Colors are explained below. |
| Middle | Name and count | Opens the room. Drag the name to reorder the list; the order is saved. |
| Right | Selection circle | Selects or deselects that agent as an instruction recipient. See below. |
Right-hand circle: choose recipients
Each click toggles selection. Selected agents receive messages in the user room and meeting room. Selected circles are bright with a check. Deselected ones are faint rings.
- Single click Selects the agent; click again to deselect.
- Quick double-click Selects every agent. Double-click again when all are selected to clear them all.
- The user room and meeting room share the same selection. Changes in one apply to the other; you do not select separately for each room.
- The user room cannot send if nobody is selected.
What do the indicator colors mean?
The light shows the agent's current state. Green means working; blue means ready. The same colors and labels always appear in the sidebar's status legend.
| Indicator | Legend label | Meaning | What to do |
|---|---|---|---|
| Green (bright emerald) | Working | The agent is processing a task. | Wait. If you need to halt it, use the center agent's Agent roomroom's Stop button or Esc. |
| Blue | Ready | Connected and waiting for new work. | You can assign a task immediately. |
| Yellow | Starting | The agent is starting or reconnecting. | Wait briefly. If it persists, check Control viewfor status. |
| Orange | Interrupted | Work was stopped and the agent awaits a new task. This can appear after Stop. | A new assignment turns it green again. |
| Red | Failed | An agent or connection problem was observed. | Read the reason in Center messages below the list before repeating the action. |
| See status legend | Limit exhausted | The AI service's usage allowance has been consumed. | Center messages includes the expected recovery time. Try again after that time. |
| Gray | Off | The agent process is not running or is disconnected. | Restart the center or check connection settings. |
assets/turtlecenter/ui-status-lights.png · Recommended size: 1600×900Agent list and status legend, preferably with actual green and blue indicators.When an agent goes offline, fails, or reaches its limit, Center messages below the list displays Agent name · Reasonin red. It disappears when the agent is ready again. Delivery failures briefly appear in the same place as Sender → Recipient · Reason .
What does the number mean?
The number after an agent's name is the cumulative character count injected into that room. It grows with conversation and starts over after reset. Zero means no accumulation yet or not confirmed.
- Bright white numbersare freshly checked values.
- Red numbersare the last known values, not freshly confirmed. Treat the count as a reference only.
- Hover over the name to see Injected total: N characters / Threshold: N charactersincluding the threshold.
The threshold is a guide for resetting context before a long conversation becomes sluggish. Settingsunder LIVE and Wake-up lets you configure Soram, Hwayeon, and Codex center agents separately. New-install defaults are 150,000, 100,000, and 150,000 characters respectively. To be confirmed Whether reaching the threshold triggers an automatic reset is under investigation.
assets/turtlecenter/ui-buffer-number.png · Recommended size: 1600×900Indicator, name/count, and selection circle, with white/red count examples and selected/deselected circles.Read next: Agent room guide → User room → Meeting room.