icon adjustment, docs coordination, sidebar adjustment, cmux and zellij polish

Author: untra

.github/workflows/vscode-extension.yaml

@@ -5,11 +5,13 @@ on:
     branches: [main]
     paths:
       - 'vscode-extension/**'
+      - 'icons/**'
       - '.github/workflows/vscode-extension.yaml'
   pull_request:
     branches: [main]
     paths:
       - 'vscode-extension/**'
+      - 'icons/**'
   workflow_dispatch:
     inputs:
       publish:

README.md

@@ -3,24 +3,25 @@
 # Operator!
 [![GitHub Tag](https://img.shields.io/github/v/tag/untra/operator)](https://github.com/untra/operator/releases) [![codecov](https://codecov.io/gh/untra/operator/branch/main/graph/badge.svg)](https://codecov.io/gh/untra/operator) [![VS Code Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/untra.operator-terminals?label=VS%20Code%20Installs)](https://marketplace.visualstudio.com/items?itemName=untra.operator-terminals)
 
+**Session** [![tmux](https://img.shields.io/badge/tmux-1BB91F?logo=tmux&logoColor=white)](https://operator.untra.io/getting-started/sessions/tmux/) [![cmux](https://img.shields.io/badge/cmux-333333)](https://operator.untra.io/getting-started/sessions/cmux/) [![Zellij](https://img.shields.io/badge/Zellij-E8590C)](https://operator.untra.io/getting-started/sessions/zellij/) [![VS Code](https://img.shields.io/badge/VS_Code-007ACC?logo=visualstudiocode&logoColor=white)](https://operator.untra.io/getting-started/sessions/vscode/) **|** **LLM Tool** [![Claude](https://img.shields.io/badge/Claude-D97757?logo=claude&logoColor=white)](https://operator.untra.io/getting-started/agents/claude/) [![Codex](https://img.shields.io/badge/Codex-000000?logo=openai&logoColor=white)](https://operator.untra.io/getting-started/agents/codex/) [![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-8E75B2?logo=googlegemini&logoColor=white)](https://operator.untra.io/getting-started/agents/gemini-cli/) **|** **Kanban Provider** [![Jira](https://img.shields.io/badge/Jira-0052CC?logo=jira&logoColor=white)](https://operator.untra.io/getting-started/kanban/jira/) [![Linear](https://img.shields.io/badge/Linear-5E6AD2?logo=linear&logoColor=white)](https://operator.untra.io/getting-started/kanban/linear/) **|** **Git Version Control** [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://operator.untra.io/getting-started/git/github/) [![GitLab](https://img.shields.io/badge/GitLab-FC6D26?logo=gitlab&logoColor=white)](https://operator.untra.io/getting-started/git/gitlab/)
 
 An orchestration tool for [**AI-assisted**](https://operator.untra.io/getting-started/agents/) [_kanban-shaped_](https://operator.untra.io/getting-started/kanban/) [git-versioned](https://operator.untra.io/getting-started/git/) software development.
 
 <a href="https://marketplace.visualstudio.com/items?itemName=untra.operator-terminals" target="_blank" class="button">Install <b>Operator! Terminals</b> extension from Visual Studio Code Marketplace</a>
 
-**Operator** is for you if: 
+**Operator** is for you if:
 
-- you do work assigned from tickets on a kanban board , such as [_Jira Cloud_](https://operator.untra.io/getting-started/kanban/jira/) or [_Linear_](https://operator.untra.io/getting-started/kanban/linear/)
-- you use llm assisted coding agent tools to accomplish work, such as [_Claude Code_](https://operator.untra.io/getting-started/agents/claude/), [_OpenAI Codex_](https://operator.untra.io/getting-started/agents/codex/)
-- your work is version controlled with git repository provider (like [_Github_](https://operator.untra.io/getting-started/git/github/))
+- you do work assigned from tickets on a kanban board, such as [_Jira Cloud_](https://operator.untra.io/getting-started/kanban/jira/) or [_Linear_](https://operator.untra.io/getting-started/kanban/linear/)
+- you use LLM assisted coding agent tools to accomplish work, such as [_Claude Code_](https://operator.untra.io/getting-started/agents/claude/), [_OpenAI Codex_](https://operator.untra.io/getting-started/agents/codex/), or [_Gemini CLI_](https://operator.untra.io/getting-started/agents/gemini-cli/)
+- your work is version controlled with a git repository provider like [_GitHub_](https://operator.untra.io/getting-started/git/github/) or [_GitLab_](https://operator.untra.io/getting-started/git/gitlab/)
 
 - you are drowning in the AI software development soup.
 
 and you are ready to start seriously automating your work.
 
 ## Overview
 
-`operator` is a TUI (terminal user interface) application that uses [Tmux](https://github.com/tmux/tmux/wiki) to manages multiple Claude Code agents across multi-project workspaces of many codebases. It is designed to be ticket-first, starting claude code keyed off from markdown stories from a ticketing provider. It provides:
+`operator` is a TUI (terminal user interface) application that uses session wrappers ([tmux](https://operator.untra.io/getting-started/sessions/tmux/), [cmux](https://operator.untra.io/getting-started/sessions/cmux/), [Zellij](https://operator.untra.io/getting-started/sessions/zellij/), or [VS Code](https://operator.untra.io/getting-started/sessions/vscode/)) to manage multiple AI coding agents across multi-project workspaces of many codebases. It is designed to be ticket-first, starting claude code keyed off from markdown stories from a ticketing provider. It provides:
 
 - **Queue Management**: ticket queue with priority-based work assignment, launchable from a dashboard
 - **Agent Orchestration**: Launch, monitor, pause/resume Claude Desktop agents against kanban shaped work tickets, and track the ticket progress as it goes through your defined work implementation steps

bindings/ActiveAgentResponse.ts

@@ -35,4 +35,20 @@ started_at: string,
 /**
  * Current workflow step
  */
-current_step: string | null, };
+current_step: string | null, 
+/**
+ * Which session wrapper is in use: "tmux", "vscode", "cmux", or "zellij"
+ */
+session_wrapper: string | null, 
+/**
+ * Session window reference ID (e.g. cmux window, tmux session)
+ */
+session_window_ref: string | null, 
+/**
+ * Session context reference (e.g. cmux workspace, zellij session)
+ */
+session_context_ref: string | null, 
+/**
+ * Session pane reference (e.g. cmux surface, zellij pane)
+ */
+session_pane_ref: string | null, };

bindings/LaunchTicketRequest.ts

@@ -5,11 +5,15 @@
  */
 export type LaunchTicketRequest = { 
 /**
- * LLM provider to use (e.g., "claude")
+ * Named delegator to use (takes precedence over provider/model)
+ */
+delegator: string | null, 
+/**
+ * LLM provider to use (e.g., "claude") — legacy fallback when no delegator
  */
 provider: string | null, 
 /**
- * Model to use (e.g., "sonnet", "opus")
+ * Model to use (e.g., "sonnet", "opus") — legacy fallback when no delegator
  */
 model: string | null, 
 /**

bindings/LaunchTicketResponse.ts

@@ -36,6 +36,10 @@ session_wrapper: string | null,
  * Session window reference ID (e.g. cmux window, tmux session)
  */
 session_window_ref: string | null, 
+/**
+ * Session context reference (e.g. cmux workspace, zellij session)
+ */
+session_context_ref: string | null, 
 /**
  * Session UUID for the LLM tool
  */

bindings/VsCodeLaunchOptions.ts

@@ -6,7 +6,11 @@ import type { VsCodeModelOption } from "./VsCodeModelOption";
  */
 export type VsCodeLaunchOptions = { 
 /**
- * Model to use (sonnet, opus, haiku)
+ * Named delegator to use (takes precedence over model)
+ */
+delegator: string | null, 
+/**
+ * Model to use (sonnet, opus, haiku) — fallback when no delegator
  */
 model: VsCodeModelOption, 
 /**

docs/_data/navigation.yml

@@ -7,6 +7,30 @@ docs:
         url: /getting-started/prerequisites/
       - title: Installation
         url: /getting-started/installation/
+      - title: Supported Session Management
+        url: /getting-started/sessions/
+        children:
+          - title: tmux
+            url: /getting-started/sessions/tmux/
+            icon: tmux
+          - title: cmux
+            url: /getting-started/sessions/cmux/
+            icon: cmux
+          - title: Zellij
+            url: /getting-started/sessions/zellij/
+            icon: zellij
+          - title: VS Code Extension
+            url: /getting-started/sessions/vscode/
+            icon: vscode
+      - title: Supported Kanban Providers
+        url: /getting-started/kanban/
+        children:
+          - title: Jira Cloud
+            url: /getting-started/kanban/jira/
+            icon: jira
+          - title: Linear
+            url: /getting-started/kanban/linear/
+            icon: linear
       - title: Supported Coding Agents
         url: /getting-started/agents/
         children:
@@ -19,21 +43,15 @@ docs:
           - title: Gemini CLI
             url: /getting-started/agents/gemini-cli/
             icon: gemini
-      - title: Supported Kanban Providers
-        url: /getting-started/kanban/
-        children:
-          - title: Jira Cloud
-            url: /getting-started/kanban/jira/
-            icon: jira
-          - title: Linear
-            url: /getting-started/kanban/linear/
-            icon: linear
       - title: Supported Git Repositories
         url: /getting-started/git/
         children:
           - title: GitHub
             url: /getting-started/git/github/
             icon: github
+          - title: GitLab
+            url: /getting-started/git/gitlab/
+            icon: gitlab
       - title: Supported Notification Integrations
         url: /getting-started/notifications/
         children:
@@ -43,15 +61,6 @@ docs:
           - title: Operating System
             url: /getting-started/notifications/os/
             icon: notification
-      - title: Supported Session Management
-        url: /getting-started/sessions/
-        children:
-          - title: tmux
-            url: /getting-started/sessions/tmux/
-            icon: tmux
-          - title: VS Code Extension
-            url: /getting-started/sessions/vscode/
-            icon: vscode
   - title: Core
     children:
       - title: Kanban

docs/_includes/sidebar.html

@@ -49,7 +49,7 @@
                 {% for grandchild in item.children %}
                 <li>
                   <a href="{{ grandchild.url | relative_url }}" {% if page.url == grandchild.url %}class="active"
-                    {% endif %}>{% if grandchild.icon %}<span class="nav-icon"><img class="icon-light" src="{{ '/assets/icons/' | append: grandchild.icon | append: '-light.svg' | relative_url }}" alt="" width="16" height="16"><img class="icon-dark" src="{{ '/assets/icons/' | append: grandchild.icon | append: '-dark.svg' | relative_url }}" alt="" width="16" height="16"></span>{% endif %}{{ grandchild.title }}</a>
+                    {% endif %}>{% if grandchild.icon %}<span class="nav-icon"><img src="{{ '/assets/icons/' | append: grandchild.icon | append: '.svg' | relative_url }}" alt="" width="16" height="16"></span>{% endif %}{{ grandchild.title }}</a>
                 </li>
                 {% endfor %}
               </ul>

docs/assets/css/main.css

@@ -323,22 +323,9 @@ summary.nav-item-row::-webkit-details-marker {
   object-fit: contain;
 }
 
-/* Light/dark icon swapping - show light by default */
-.nav-icon .icon-dark {
-  display: none;
-}
-
-.nav-icon .icon-light {
-  display: inline-block;
-}
-
-/* In dark mode, show dark icons and hide light icons */
-[data-theme="dark"] .nav-icon .icon-dark {
-  display: inline-block;
-}
-
-[data-theme="dark"] .nav-icon .icon-light {
-  display: none;
+/* Dark mode: invert icon colors */
+[data-theme="dark"] .nav-icon img {
+  filter: invert(1) brightness(1.1) sepia(0.3);
 }
 
 /* Downloads nav link - highlighted */