feat(cortex-tui): add interactive /agents command for agent management (#220)

- Add new agents builder module with TUI selectors for:
  - Listing all agents (built-in + project + global)
  - Creating new agents (project/global, AI/manual)
  - Permission selection for new agents
  - Confirmation flow for agent creation

- Update ModalType to include Agents variant
- Update command executor to open Agents modal
- Add InteractiveAction handling for agents workflow
- Add agent creation state fields to AppState
- Add helper methods for saving agents and injecting chat events
- Support both TOML and Markdown frontmatter agent files

This provides a TUI interface similar to /settings for agent management,
allowing users to list, select, and create custom agents directly from
the command line interface.

Co-authored-by: Droid Agent <droid@factory.ai>

Author: echobt

Cargo.lock

@@ -35,6 +35,8 @@ async-trait = { workspace = true }
 # Serialization
 serde = { workspace = true }
 serde_json = { workspace = true }
+serde_yaml = { workspace = true }
+toml = { workspace = true }
 
 # Error handling
 anyhow = { workspace = true }

cortex-tui/Cargo.toml

@@ -607,6 +607,13 @@ pub struct AppState {
     pub analytics_enabled: bool,
     /// Current operation mode (Build/Plan/Spec)
     pub operation_mode: OperationMode,
+    // Agent creation state
+    /// Agent creation location (project or global)
+    pub agent_creation_location: Option<crate::interactive::builders::AgentLocation>,
+    /// Agent creation method mode ("ai" or "manual_name")
+    pub agent_creation_mode: Option<String>,
+    /// Agent creation configuration in progress
+    pub agent_creation_config: Option<crate::interactive::builders::NewAgentConfig>,
 }
 
 impl AppState {
@@ -687,6 +694,10 @@ impl AppState {
             telemetry_enabled: false,
             analytics_enabled: false,
             operation_mode: OperationMode::default(),
+            // Agent creation state
+            agent_creation_location: None,
+            agent_creation_mode: None,
+            agent_creation_config: None,
         }
     }
 

cortex-tui/src/app.rs

@@ -81,7 +81,7 @@ impl CommandExecutor {
             "palette" | "cmd" => CommandResult::OpenModal(ModalType::CommandPalette),
             "init" => self.cmd_init(cmd),
             "commands" | "cmds" => CommandResult::Async("commands:list".to_string()),
-            "agents" | "subagents" => CommandResult::Async("agents:list".to_string()),
+            "agents" | "subagents" => CommandResult::OpenModal(ModalType::Agents),
             "copy" | "cp" => CommandResult::Message(
                 "To copy text from Cortex:\n\n\
                  - Hold SHIFT while selecting text with mouse\n\
@@ -1137,7 +1137,7 @@ mod tests {
         let result = executor.execute_str("/agents");
         assert!(matches!(
             result,
-            CommandResult::Async(ref s) if s == "agents:list"
+            CommandResult::OpenModal(ModalType::Agents)
         ));
     }
 

cortex-tui/src/commands/executor.rs

@@ -263,7 +263,7 @@ pub fn register_builtin_commands(registry: &mut CommandRegistry) {
     registry.register(CommandDef::new(
         "agents",
         &["subagents"],
-        "List all available custom agents",
+        "List and manage custom agents",
         "/agents",
         CommandCategory::General,
         false,

cortex-tui/src/commands/registry.rs

@@ -154,6 +154,8 @@ pub enum ModalType {
     Login,
     /// Upgrade modal for self-update
     Upgrade,
+    /// Agents manager modal for listing and creating agents
+    Agents,
 }
 
 impl ModalType {
@@ -178,6 +180,7 @@ impl ModalType {
             ModalType::McpManager => "MCP Servers",
             ModalType::Login => "Login",
             ModalType::Upgrade => "Upgrade",
+            ModalType::Agents => "Agents",
         }
     }
 }