Skip to content

fix: Add UUID disambiguation for duplicate agent names#539

Open
szmania wants to merge 12 commits into
cecli-dev:mainfrom
szmania:cli-39-agent-specific-status-messages-2
Open

fix: Add UUID disambiguation for duplicate agent names#539
szmania wants to merge 12 commits into
cecli-dev:mainfrom
szmania:cli-39-agent-specific-status-messages-2

Conversation

@szmania
Copy link
Copy Markdown

@szmania szmania commented May 29, 2026

Summary

This PR enhances the TUI to provide better visibility into which agent is performing tasks, especially when multiple sub-agents are active. It also improves how status messages (spinners, confirmations, and errors) are attributed to specific agents using their UUIDs.

Changes

🤖 Agent Identification & Disambiguation

  • Agent Name Resolution: Added logic in cecli/tui/app.py to resolve agent names from coder_uuid.
  • Sub-agent Prefixing: TUI status messages (spinners, confirmations, and errors) now include the agent's name.
  • Primary Agent Status: When sub-agents are present, the primary agent is identified as (primary) in the TUI.
  • Duplicate Name Handling: If multiple sub-agents share the same name, they are disambiguated by appending the first 3 characters of their UUID (e.g., researcher (a1b)).

🔄 Improved Status Attribution

  • UUID Propagation: Updated BaseCoder and TUI.IO to pass coder_uuid through spinner and other status updates. This ensures that TUI updates are correctly routed to the appropriate agent context.
  • Enhanced TUI Components:
    • MainFooter now displays the active agent's name alongside the spinner.
    • StatusBar now prefixes notifications and confirmation prompts with the agent's name.

🛠️ Refactors & Fixes

  • Utility Update: Replaced oslex.join with shlex.join in cecli/utils.py for better shell command escaping.
  • Test Coverage: Added new TUI tests in tests/tui/test_app.py to verify agent name prefixing in various status message types.

Impact

Users will now have a clearer understanding of which agent is currently active and performing work in the TUI, improving the overall experience when using complex agentic workflows.

Your Name added 12 commits May 27, 2026 22:08
Co-authored-by: cecli (openai/gemini_ai_studio/gemini-3-flash-preview)
Co-authored-by: cecli (openai/nvidia_nim/deepseek-ai/deepseek-v4-pro)
Co-authored-by: cecli (openai/gemini_cli_local/gemini-2.5-pro)
Co-authored-by: cecli (openai/nvidia_nim/deepseek-ai/deepseek-v4-pro)
Co-authored-by: cecli (openai/agentic)
Co-authored-by: cecli (openai/agentic)
Co-authored-by: cecli (openai/agentic)
Co-authored-by: cecli (openai/gemini_cli_local/gemini-2.5-pro)
Co-authored-by: cecli (openai/gemini_cli_local/gemini-2.5-pro)
Co-authored-by: cecli (openai/gemini_cli_local/gemini-2.5-pro)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant