refactor: rename Fabric to Cortex throughout the codebase (#187)

- Rename all FABRIC_* environment variables to CORTEX_*
- Rename FabricPaths, FabricFeedback, etc. structs to Cortex*
- Update all comments, documentation, and help text
- Update shell integration scripts
- Update TypeScript/JavaScript code and CSS files
- Update configuration file references (.fabric -> .cortex)
- Update service names and identifiers
- Update test assertions and mock data

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

Author: echobt

CORTEX_CLI_ANALYSIS.md

@@ -80,7 +80,7 @@ cortex-cli/src/
 
 ```rust
 // run_cmd.rs:455
-// TODO: Implement full server attachment when fabric SDK client is available
+// TODO: Implement full server attachment when cortex SDK client is available
 
 // run_cmd.rs:793
 // TODO: Implement session sharing when API is available
@@ -664,7 +664,7 @@ let mut stats = UsageStats::default();
 Loads all sessions into memory even when filtering:
 
 ```rust
-let sessions = cortex_engine::list_sessions(&config.fabric_home)?;
+let sessions = cortex_engine::list_sessions(&config.cortex_home)?;
 // Then filters...
 ```
 
@@ -825,7 +825,7 @@ No explicit offline mode or cached operation support.
 ### 1. Naming Conventions
 
 ```rust
-fabric_home  // Uses "fabric" internally
+cortex_home  // Uses "cortex" internally
 cortex_home  // Also used
 .cortex      // Directory name
 ```
@@ -916,7 +916,7 @@ Inconsistent use of short flags:
 3. Use tokio::fs for async file operations
 4. Implement retry logic for network operations
 5. Add caching for agent loading
-6. Standardize naming (fabric vs cortex)
+6. Standardize naming (cortex naming)
 
 ### 🟢 Low Priority (Nice to Have)
 

IMPROVEMENTS_STATUS.md

@@ -171,7 +171,7 @@ This document analyzes which improvements from previously merged PRs are already
 | PR | Description | Status |
 |----|-------------|--------|
 | PR 30 | Show alternative workflow when removing built-in agent | `agent_cmd.rs` - bails on builtin, no alternative shown |
-| PR 16 | Use uppercase CORTEX_HOME env var | `debug_cmd.rs` shows FABRIC_HOME, may need CORTEX_HOME |
+| PR 16 | Use uppercase CORTEX_HOME env var | `debug_cmd.rs` shows CORTEX_HOME |
 
 ---
 

cortex-app-server/src/api.rs

@@ -365,7 +365,7 @@ pub struct DiscoverResponse {
 ///   "servers": [
 ///     {
 ///       "name": "cortex-8080",
-///       "fullname": "cortex-8080._fabric._tcp.local.",
+///       "fullname": "cortex-8080._cortex._tcp.local.",
 ///       "host": "mycomputer.local.",
 ///       "port": 8080,
 ///       "addresses": ["192.168.1.100"],
@@ -810,7 +810,7 @@ pub struct ChatUsage {
 
 /// Handle chat completions by calling the actual LLM provider.
 /// NOTE: This endpoint is temporarily disabled as the providers module was removed.
-/// Use the TUI (cargo run --bin fabric) for LLM completions instead.
+/// Use the TUI (cargo run --bin cortex) for LLM completions instead.
 async fn chat_completions(
     State(_state): State<Arc<AppState>>,
     Json(req): Json<ChatCompletionRequest>,
@@ -829,7 +829,7 @@ async fn chat_completions(
             index: 0,
             message: ChatMessage {
                 role: "assistant".to_string(),
-                content: "Chat completions API endpoint is temporarily disabled. The providers module was removed during dead code cleanup. Please use the TUI (cargo run --bin fabric) for LLM interactions.".to_string(),
+                content: "Chat completions API endpoint is temporarily disabled. The providers module was removed during dead code cleanup. Please use the TUI (cargo run --bin cortex) for LLM interactions.".to_string(),
                 tool_call_id: None,
                 tool_calls: None,
             },
@@ -1680,7 +1680,7 @@ pub struct GeneratePromptResponse {
     pub permission_mode: String,
 }
 
-/// Generate an agent prompt using AI via fabric-core.
+/// Generate an agent prompt using AI via cortex-core.
 /// NOTE: This endpoint is temporarily disabled as the providers module was removed.
 async fn generate_agent_prompt(
     State(_state): State<Arc<AppState>>,

cortex-app-server/src/auth.rs

@@ -53,7 +53,7 @@ impl Claims {
             exp: now + expiry_seconds,
             iat: now,
             iss: "Cortex".to_string(),
-            aud: vec!["fabric-api".to_string()],
+            aud: vec!["cortex-api".to_string()],
             roles: vec![],
             metadata: HashMap::new(),
         }
@@ -304,7 +304,7 @@ pub async fn auth_middleware(
             // Configure validation
             let mut validation = Validation::default();
             validation.set_issuer(&["Cortex"]);
-            validation.set_audience(&["fabric-api"]);
+            validation.set_audience(&["cortex-api"]);
             validation.validate_exp = true;
             validation.validate_nbf = false;
 

cortex-app-server/src/config.rs

@@ -114,15 +114,15 @@ impl ServerConfig {
     pub fn from_env() -> anyhow::Result<Self> {
         let mut config = Self::default();
 
-        if let Ok(addr) = std::env::var("FABRIC_LISTEN_ADDR") {
+        if let Ok(addr) = std::env::var("CORTEX_LISTEN_ADDR") {
             config.listen_addr = addr;
         }
 
         if let Ok(key) = std::env::var("CORTEX_API_KEY") {
             config.auth.api_keys.push(key);
         }
 
-        if let Ok(secret) = std::env::var("FABRIC_JWT_SECRET") {
+        if let Ok(secret) = std::env::var("CORTEX_JWT_SECRET") {
             config.auth.jwt_secret = Some(secret);
         }
 
@@ -135,11 +135,11 @@ impl ServerConfig {
         }
 
         // mDNS configuration from environment
-        if let Ok(mdns_enabled) = std::env::var("FABRIC_MDNS_ENABLED") {
+        if let Ok(mdns_enabled) = std::env::var("CORTEX_MDNS_ENABLED") {
             config.mdns.enabled = mdns_enabled.parse().unwrap_or(false);
         }
 
-        if let Ok(mdns_name) = std::env::var("FABRIC_MDNS_SERVICE_NAME") {
+        if let Ok(mdns_name) = std::env::var("CORTEX_MDNS_SERVICE_NAME") {
             config.mdns.service_name = Some(mdns_name);
         }
 

cortex-app-server/src/handlers.rs

@@ -23,7 +23,7 @@ use crate::tools::ToolExecutor;
 
 /// Streaming completion handler.
 /// NOTE: This endpoint is temporarily disabled as the providers module was removed.
-/// Use the TUI (cargo run --bin fabric) for LLM completions instead.
+/// Use the TUI (cargo run --bin cortex) for LLM completions instead.
 pub async fn stream_completion(
     State(_state): State<Arc<AppState>>,
     Json(_req): Json<StreamCompletionRequest>,
@@ -32,7 +32,7 @@ pub async fn stream_completion(
     // Return a stream with a single error message
     let stream = async_stream::stream! {
         let error_event = StreamEvent::Error {
-            message: "Streaming completions API endpoint is temporarily disabled. The providers module was removed during dead code cleanup. Please use the TUI (cargo run --bin fabric) for LLM interactions.".to_string()
+            message: "Streaming completions API endpoint is temporarily disabled. The providers module was removed during dead code cleanup. Please use the TUI (cargo run --bin cortex) for LLM interactions.".to_string()
         };
         let data = serde_json::to_string(&error_event).unwrap_or_default();
         yield Ok(axum::response::sse::Event::default().data(data));

cortex-app-server/src/lib.rs

@@ -2,14 +2,14 @@
 //!
 //! This crate provides:
 //! - REST API for managing sessions and conversations
-//! - WebSocket API for real-time streaming using real fabric-core Sessions
+//! - WebSocket API for real-time streaming using real cortex-core Sessions
 //! - Authentication and authorization
 //! - Rate limiting and request validation
 //! - Health checks and metrics
 //! - Static file serving for web UI
 //! - mDNS/Bonjour service discovery for automatic server discovery
 //!
-//! The server uses fabric-core's Session system to provide the same
+//! The server uses cortex-core's Session system to provide the same
 //! tool execution capabilities as the CLI (Execute, Read, Create, Edit, etc.)
 
 #![deny(clippy::print_stdout, clippy::print_stderr)]

cortex-app-server/src/mdns.rs

@@ -4,7 +4,7 @@
 //! - `MdnsPublisher`: Publishes the Cortex server as a discoverable service on the local network
 //! - `MdnsDiscovery`: Discovers other Cortex servers on the local network
 //!
-//! The service is published under the `_fabric._tcp.local.` service type.
+//! The service is published under the `_cortex._tcp.local.` service type.
 
 use std::collections::HashMap;
 use std::net::IpAddr;
@@ -18,7 +18,7 @@ use tracing::{debug, error, info, warn};
 use crate::error::{AppError, AppResult};
 
 /// The mDNS service type for Cortex servers.
-pub const SERVICE_TYPE: &str = "_fabric._tcp.local.";
+pub const SERVICE_TYPE: &str = "_cortex._tcp.local.";
 
 /// mDNS publisher for advertising the Cortex server on the local network.
 pub struct MdnsPublisher {
@@ -160,7 +160,7 @@ impl Drop for MdnsPublisher {
 pub struct DiscoveredServer {
     /// The instance name of the service.
     pub name: String,
-    /// The full service name (e.g., "cortex-8080._fabric._tcp.local.").
+    /// The full service name (e.g., "cortex-8080._cortex._tcp.local.").
     pub fullname: String,
     /// The hostname of the server.
     pub host: String,
@@ -527,7 +527,7 @@ mod tests {
     fn test_discovered_server_url() {
         let server = DiscoveredServer {
             name: "test-server".to_string(),
-            fullname: "test-server._fabric._tcp.local.".to_string(),
+            fullname: "test-server._cortex._tcp.local.".to_string(),
             host: "myhost.local.".to_string(),
             port: 8080,
             addresses: vec!["192.168.1.100".parse().unwrap(), "::1".parse().unwrap()],
@@ -548,7 +548,7 @@ mod tests {
     fn test_discovered_server_url_ipv6_only() {
         let server = DiscoveredServer {
             name: "test-server".to_string(),
-            fullname: "test-server._fabric._tcp.local.".to_string(),
+            fullname: "test-server._cortex._tcp.local.".to_string(),
             host: "myhost.local.".to_string(),
             port: 8080,
             addresses: vec!["2001:db8::1".parse().unwrap()],
@@ -563,7 +563,7 @@ mod tests {
     fn test_discovered_server_url_hostname_fallback() {
         let server = DiscoveredServer {
             name: "test-server".to_string(),
-            fullname: "test-server._fabric._tcp.local.".to_string(),
+            fullname: "test-server._cortex._tcp.local.".to_string(),
             host: "myhost.local.".to_string(),
             port: 8080,
             addresses: vec![],

cortex-app-server/src/session_manager.rs

@@ -1,6 +1,6 @@
-//! Session manager - bridges WebSocket clients to fabric-core Sessions.
+//! Session manager - bridges WebSocket clients to cortex-core Sessions.
 //!
-//! This module creates real fabric-core Sessions and routes WebSocket messages
+//! This module creates real cortex-core Sessions and routes WebSocket messages
 //! to the CLI's SQ/EQ (Submission Queue / Event Queue) system.
 
 use std::collections::HashMap;
@@ -37,7 +37,7 @@ impl std::fmt::Debug for SessionManager {
 pub struct ManagedSession {
     /// Session ID.
     pub id: String,
-    /// Conversation ID from fabric-core.
+    /// Conversation ID from cortex-core.
     pub conversation_id: ConversationId,
     /// Handle to interact with the session.
     pub handle: SessionHandle,
@@ -90,7 +90,7 @@ impl SessionManager {
     ) -> Result<SessionInfo, SessionError> {
         let session_id = Uuid::new_v4().to_string();
 
-        // Build fabric-core Config
+        // Build cortex-core Config
         let mut config = CoreConfig::default();
 
         // In cloud/server mode, never ask for approval - auto-approve everything
@@ -492,7 +492,7 @@ impl SessionManager {
 
         let new_session_id = Uuid::new_v4().to_string();
 
-        // Build fabric-core Config from original
+        // Build cortex-core Config from original
         let mut config = CoreConfig::default();
         config.model = model;
         config.cwd = cwd;
@@ -767,7 +767,7 @@ async fn forward_events_shared(
     debug!(session_id = %sid, "Event forwarder (shared) finished");
 }
 
-/// Convert a fabric-protocol Event to a WebSocket message.
+/// Convert a cortex-protocol Event to a WebSocket message.
 fn convert_event_to_ws(event: &Event) -> Option<WsMessage> {
     match &event.msg {
         // Streaming content

cortex-app-server/src/state.rs

@@ -21,7 +21,7 @@ pub struct AppState {
     pub config: ServerConfig,
     /// Active sessions (legacy API state).
     sessions: RwLock<HashMap<String, SessionState>>,
-    /// CLI session manager - manages real fabric-core Sessions (WebSocket).
+    /// CLI session manager - manages real cortex-core Sessions (WebSocket).
     pub cli_sessions: SessionManager,
     /// CLI session manager for HTTP streaming.
     pub cli_session_manager: CliSessionManager,