feat(tui): adopt Herdr-style agent plugins and journal projections

.github/workflows/cmux-tui-build-package.yml

@@ -62,6 +62,11 @@ on:
         required: false
         default: false
         type: boolean
+      build_agent_plugin:
+        description: "Build and upload the Unix userland agent screen-detection plugin"
+        required: false
+        default: false
+        type: boolean
 
 permissions: {}
 
@@ -279,7 +284,34 @@ jobs:
           cargo build -p cmux-relay --bin cmux-relay --release --locked --target ${{ matrix.build_target }}
           cargo build -p chatmux-relay --bin chatmux-relay --release --locked --target ${{ matrix.build_target }}
 
+      - name: Build agent screen-detection plugin
+        if: inputs.build_agent_plugin && runner.os != 'Windows'
+        env:
+          AGENT_PLUGIN_CROSS: ${{ matrix.cross }}
+          AGENT_PLUGIN_TARGET: ${{ matrix.build_target }}
+          RUNNER_OS: ${{ runner.os }}
+        working-directory: cmux-tui
+        shell: bash
+        run: |
+          set -euo pipefail
+          plugin_manifest="bindings/examples/rust-agent-screen-detection/Cargo.toml"
+          # The reference plugin is its own Cargo workspace. Use the common
+          # target directory so staging has one predictable path and the
+          # plugin can reuse SDK dependencies from the TUI build.
+          export CARGO_TARGET_DIR="$GITHUB_WORKSPACE/cmux-tui/target"
+          if [[ "$AGENT_PLUGIN_CROSS" == "true" && "$RUNNER_OS" == "Linux" ]]; then
+            cargo zigbuild \
+              --manifest-path "$plugin_manifest" \
+              --release --locked --target "$AGENT_PLUGIN_TARGET"
+          else
+            cargo build \
+              --manifest-path "$plugin_manifest" \
+              --release --locked --target "$AGENT_PLUGIN_TARGET"
+          fi
+
       - name: Stage binary
+        env:
+          BUILD_AGENT_PLUGIN: ${{ inputs.build_agent_plugin }}
         shell: bash
         run: |
           mkdir -p dist
@@ -290,6 +322,10 @@ jobs:
           cp "cmux-tui/target/${{ matrix.target }}/release/cmux-tui-hook${{ matrix.ext }}" "$hook_binary"
           cp "cmux-tui/target/${{ matrix.target }}/release/cmux-relay${{ matrix.ext }}" "$relay_binary"
           cp "cmux-tui/target/${{ matrix.target }}/release/chatmux-relay${{ matrix.ext }}" "dist/chatmux-relay-${{ matrix.target }}${{ matrix.ext }}"
+          if [[ "$BUILD_AGENT_PLUGIN" == "true" && "${{ runner.os }}" != "Windows" ]]; then
+            cp "cmux-tui/target/${{ matrix.target }}/release/cmux-agent-screen-detection${{ matrix.ext }}" \
+              "dist/cmux-agent-screen-detection-${{ matrix.target }}${{ matrix.ext }}"
+          fi
           if [[ -n "${{ matrix.compatibility_target }}" ]]; then
             cp "$binary" "dist/cmux-tui-${{ matrix.compatibility_target }}${{ matrix.ext }}"
             cp "$hook_binary" "dist/cmux-tui-hook-${{ matrix.compatibility_target }}${{ matrix.ext }}"
@@ -356,6 +392,14 @@ jobs:
           path: dist/chatmux-relay-*${{ matrix.ext }}
           if-no-files-found: error
 
+      - name: Upload agent screen-detection plugin artifact
+        if: inputs.build_agent_plugin && runner.os != 'Windows'
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: cmux-agent-screen-detection-${{ matrix.target }}
+          path: dist/cmux-agent-screen-detection-*${{ matrix.ext }}
+          if-no-files-found: error
+
   build-windows:
     name: build x86_64-pc-windows-gnu
     if: inputs.include_windows

.github/workflows/cmux-tui-sdks.yml

@@ -530,6 +530,9 @@ jobs:
           cargo +1.88.0 fmt --manifest-path cmux-tui/bindings/rust/Cargo.toml -- --check
           cargo +1.88.0 test --manifest-path cmux-tui/bindings/rust/Cargo.toml --locked
           cargo +1.88.0 test --manifest-path cmux-tui/bindings/rust-sidebar/Cargo.toml --locked
+          cargo +1.88.0 test \
+            --manifest-path cmux-tui/bindings/examples/rust-agent-screen-detection/Cargo.toml \
+            --locked
           cargo +1.88.0 clippy \
             --manifest-path cmux-tui/bindings/examples/rust-agent-dashboard/Cargo.toml \
             --locked \

.github/workflows/cmux-tui.yml

@@ -466,6 +466,19 @@ jobs:
       - name: Test isolated TUI test-runner policy
         run: python3 .github/scripts/test_run_cmux_tui_core_tests_isolated.py
 
+      - name: cargo fmt
+        id: rustfmt-check
+        working-directory: cmux-tui
+        run: cargo fmt --check
+
+      - name: userland agent plugin package tests
+        working-directory: cmux-tui
+        # The reference plugin is an independent Cargo workspace, so the
+        # daemon workspace test does not compile it. Keep this explicit check
+        # in both hosted OS lanes.
+        run: cargo test --manifest-path bindings/examples/rust-agent-screen-detection/Cargo.toml --locked
+
+
       - name: focused Linux journal process-fence test
         if: inputs.mode == 'focused' && runner.os == 'Linux'
         working-directory: cmux-tui
@@ -819,6 +832,8 @@ jobs:
       package_pypi: ${{ inputs.mode == 'full' }}
       include_windows: ${{ inputs.mode == 'full' }}
       target_set: ${{ inputs.mode == 'full' && 'all' || 'macos-arm64' }}
+      # Build the exact reference plugin beside the daemon artifact.
+      build_agent_plugin: true
       verify_linux_arm64: ${{ inputs.mode == 'full' }}
       macos_runner: blacksmith-6vcpu-macos-15
       linux_runner: blacksmith-4vcpu-ubuntu-2404

Assets.xcassets/AgentIcons/ATTRIBUTIONS.md

@@ -0,0 +1,5 @@
+# Agent icons
+
+Cursor, Gemini, Kiro, GitHub Copilot, CodeBuddy, Qoder, Kimi and Ollama SVGs come from [Lobe Icons](https://github.com/lobehub/lobe-icons/tree/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-svg/icons) under the MIT license in `LOBE-LICENSE.txt`. Original SVG paths are unchanged; currentColor is replaced with black and white for light and dark appearances.
+
+Factory uses its [published site icon](https://factory.ai/icon.svg), retrieved on 2026-09-17. The redundant outer SVG wrapper is removed for asset-catalog compatibility.

Assets.xcassets/AgentIcons/CodeBuddy.imageset/Contents.json

@@ -0,0 +1,15 @@
+{
+  "images": [
+    {
+      "filename": "CodeBuddy.svg",
+      "idiom": "universal"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  },
+  "properties": {
+    "preserves-vector-representation": true
+  }
+}

Assets.xcassets/AgentIcons/Copilot.imageset/Contents.json

@@ -0,0 +1,25 @@
+{
+  "images": [
+    {
+      "filename": "Copilot.svg",
+      "idiom": "universal"
+    },
+    {
+      "filename": "Copilot-dark.svg",
+      "idiom": "universal",
+      "appearances": [
+        {
+          "appearance": "luminosity",
+          "value": "dark"
+        }
+      ]
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  },
+  "properties": {
+    "preserves-vector-representation": true
+  }
+}

Assets.xcassets/AgentIcons/Cursor.imageset/Contents.json

@@ -0,0 +1,25 @@
+{
+  "images": [
+    {
+      "filename": "Cursor.svg",
+      "idiom": "universal"
+    },
+    {
+      "filename": "Cursor-dark.svg",
+      "idiom": "universal",
+      "appearances": [
+        {
+          "appearance": "luminosity",
+          "value": "dark"
+        }
+      ]
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  },
+  "properties": {
+    "preserves-vector-representation": true
+  }
+}

Assets.xcassets/AgentIcons/Factory.imageset/Contents.json

@@ -0,0 +1,15 @@
+{
+  "images": [
+    {
+      "filename": "Factory.svg",
+      "idiom": "universal"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  },
+  "properties": {
+    "preserves-vector-representation": true
+  }
+}