kward 0.76.0 → 0.78.0

data/doc/usage.md

@@ -78,7 +78,7 @@ For several commands, enter the embedded Kward shell:
 /shell
 ```
 
-`/shell` opens `ekwsh`, a Kward-native command mode. Kward keeps the tab bar, composer editing, and transcript rendering while each command runs through your configured shell. Built-ins such as `cd`, `pwd`, `export`, `unset`, `alias`, `clear`, `pty`, and `exit` maintain shell-mode state between commands. Plain Tab completes built-in command names, configured aliases, executables from `$PATH`, and file paths from the shell's current directory; `cd` completion suggests directories only. `ekwsh` preserves safe ANSI SGR color/style output while stripping terminal-control sequences that could corrupt the TUI, and sets conservative color-friendly environment defaults such as `CLICOLOR=1`, `COLORTERM=truecolor`, and `TERM=xterm-256color` when needed. Use `pty git log` or `/pty git log` when you intentionally want to hand the terminal to an interactive tool such as `less` or `vim`. You can set global shell env vars and aliases in `~/.kward/ekwsh.yml`; see [Configuration](configuration.md).
+`/shell` opens `ekwsh`, a Kward-native command mode that keeps the tab bar and transcript visible. It preserves state such as the current directory, environment variables, and aliases between commands. Use `pty git log` or `/pty git log` when you intentionally want to hand the terminal to an interactive tool such as `less` or `vim`. See [Embedded shell](shell.md) for built-ins, completion, configuration, ANSI handling, PTY passthrough, and limitations.
 
 ## Shell commands
 
@@ -113,7 +113,7 @@ kward --skip-config edit ~/.kward/config.json
 
 ## Interactive slash commands
 
-Slash commands run local actions in the current session. Most do not send a prompt to the model; exceptions like `/git` and `/workers` orchestrate local flows that may then trigger model work.
+Slash commands run local actions in the current session. Most do not send a prompt to the model; exceptions like `/git` orchestrate local flows that may then trigger model work.
 
 | Command | Use it when you want to... |
 | --- | --- |
@@ -125,7 +125,7 @@ Slash commands run local actions in the current session. Most do not send a prom
 | `/files` | browse project files in a nested tree and open them in the editor. |
 | `/shell` | run workspace commands in the embedded Kward shell. |
 | `/pty <command>` | hand the terminal to an interactive command such as `git log`/`less` or `vim`. |
-| `/settings` | configure prompt overlays. |
+| `/settings` | configure models, accounts, memory, interface, tools, context, personalization, and logging. |
 | `/status` | see session, model, and context status. |
 | `/new` | start a fresh session in the current tab. |
 | `/tab 2` | switch to tab 2. |
@@ -140,6 +140,7 @@ Slash commands run local actions in the current session. Most do not send a prom
 | `/session name <name>` | name or clear the current session. |
 | `/rename <name>` | rename the current session. |
 | `/clone` | copy the current session into a new branch. |
+| `/fork` | fork from an earlier prompt into a new session. |
 | `/rewind` | revisit an earlier prompt and try a different direction. |
 | `/tree` | inspect and navigate the full technical session tree. |
 | `/copy last` | copy the latest assistant answer. |
@@ -147,39 +148,21 @@ Slash commands run local actions in the current session. Most do not send a prom
 | `/export notes.md` | write the transcript to a Markdown file. |
 | `/compact [instructions]` | summarize older context so a long chat can continue. |
 | `/memory ...` | manage opt-in memory. |
+| `/skill <name>` | activate a configured skill explicitly for the current session. |
+| `/stats [range]` | summarize enabled local telemetry. |
+| `/hooks ...` | inspect, diagnose, trust, or untrust lifecycle hooks. |
+| `/scratchpad [text|markdown|ruby]` | open an unsaved editor buffer. |
 | `/redraw` | fix terminal drawing after resize or glitches. |
 | `/reload` | reload installed plugins. |
-| `/workers` | open the experimental worker pipeline (`new`, `do <task>`, or `list`). |
-| `/queue` | manage the experimental tab-backed worker queue (`add`, `list`, `open <id>`, `run`, `suspend <id>`, or `resume <id>`). |
 | `/exit` | leave Kward. |
+| `/quit` | alias for `/exit`. |
 
-Prompt templates and plugins can add more slash commands.
-
-### Experimental tab-backed worker queue
-
-Start Kward with `--experimental-workers` to try the tab-backed worker queue. The queue is an MVP for turning an existing tab/session into implementation work that can be reviewed later.
-
-Typical flow:
-
-```text
-/plan Add retry handling to webhook delivery
-/queue add
-/queue run
-/queue open <id>
-```
-
-`/queue add` stores the current tab session as a queued worker job. `/queue run` drains queued jobs one at a time. Each job continues its saved session as an implementation worker, starts only from a clean git workspace, commits any resulting changes, and then becomes `ready_for_review`. Use `/queue open <id>` to inspect the worker session, test the feature yourself, and continue the same session if a follow-up fix is needed.
-
-Current MVP limitations:
-
-- The queue is manual: run it with `/queue run` when you want it to work.
-- Jobs run sequentially and stop when one becomes `blocked` or `failed`.
-- A job will not start if the workspace is dirty; clean, commit, or stash your changes first.
-- `/queue suspend <id>` and `/queue resume <id>` provide explicit stash-based parking primitives, but automatic foreground-tool-triggered yielding is not wired yet.
-- The queue is experimental and stores metadata locally in Kward's config directory.
+Prompt templates, configured skills, and plugins can add more slash commands. Their commands appear in the interactive slash-command picker alongside built-ins.
 
 ## Prompt history
 
+The [Interactive composer](composer.md) guide covers multiline editing, slash and file completion, reasoning shortcuts, busy input, cancellation, attachments, and terminal compatibility.
+
 In interactive mode, Kward keeps prompt history per workspace under `~/.kward/history/`. Press Up/Down to recall previous prompts across restarts.
 
 Press `Ctrl-R` to search history. Type a fuzzy query in the composer, use Up/Down to choose a result from the overlay, then press Enter to place it back in the composer for editing or resubmission. Press Esc or Ctrl-C to cancel the search and restore the draft.
@@ -260,7 +243,7 @@ Important guardrails:
 
 ## Images
 
-If the active model supports images, Kward can attach image paths, Markdown image links, `file://` URLs, or image data URLs pasted into the composer. Supported formats are GIF, JPEG, PNG, and WebP, up to 20 MB per image.
+If the active model supports images, Kward can attach image paths, Markdown image links, `file://` URLs, or image data URLs pasted into the composer. Supported formats are GIF, JPEG, PNG, and WebP, up to 20 MB per image. See [Interactive composer](composer.md#Attach_images) for attachment badges, removal, and terminal previews.
 
 Use this for tasks such as:
 
@@ -270,13 +253,13 @@ This screenshot shows the broken layout. Find the likely CSS issue.
 
 ## Pan mode
 
-Pan mode starts a simple LAN web UI:
+Pan mode starts a mobile-friendly LAN web UI:
 
 ```bash
 kward --working-directory ~/code/project pan
 ```
 
-Use it only on trusted networks. It exposes the same file, shell, and web tools through a browser UI and requires credentials configured in `config.json`. See [Configuration](configuration.md).
+Use it only on trusted networks. It exposes file, shell, web, and configured extension tools through a browser UI and requires credentials configured in `config.json`. Pan saves conversations to the normal workspace session store; its session drawer can create, resume, rename, and delete sessions. Session changes are disabled while turns are active or queued. See [Pan mode](pan.md) for setup, browser workflows, security, and limitations.
 
 ## RPC backend
 

data/doc/web-search.md

@@ -85,7 +85,9 @@ Arguments:
 - `max_bytes`: default 16384, capped at 131072.
 - `extract`: optional `auto`, `text`, or `markdown`.
 
-In `auto` mode (default), Kward detects HTML content and extracts readable text by stripping scripts, styles, navigation, and forms, preserving headings, paragraphs, lists, code blocks, and blockquotes. Non-HTML content is returned as cleaned text. Use `markdown` to format extracted headings and code blocks as Markdown, or `text` for plain text without formatting.
+In `auto` mode (default), Kward detects HTML content and extracts readable text while stripping scripts, styles, navigation prose, and forms. It preserves headings, paragraphs, ordered and unordered lists, code blocks, blockquotes, simple tables, and inline link destinations. A bounded `Links` section lists discovered main-content and navigation destinations so an agent can continue through a site without raw HTML. Relative links are resolved against the final fetched URL. Non-HTML content is returned as cleaned text. Use `markdown` to retain Markdown structure, or `text` for plain text with link destinations in parentheses.
+
+Kward downloads and parses up to 2 MB of a page before applying `max_bytes` to the extracted result. This lets pages with large scripts or metadata before their main content remain readable while keeping model-facing output bounded. Responses above the download limit are rejected rather than parsed as incomplete HTML.
 
 Fetches follow up to 5 redirects and use a 10-second HTTP timeout.
 
@@ -99,4 +101,4 @@ Arguments:
 - `max_bytes`: default 16384, capped at 131072.
 - `accept`: optional HTTP `Accept` header.
 
-Fetches follow up to 5 redirects and use a 10-second HTTP timeout.
+Fetches follow up to 5 redirects, enforce the requested byte limit while reading the response, and use a 10-second HTTP timeout.

data/lib/kward/ansi.rb

@@ -262,8 +262,8 @@ module Kward
     end
 
     def inline_links(text, enabled: enabled?)
-      text.split(/(\[[^\]\n]+\]\([^)\s\n]+\))/).map do |part|
-        if (match = part.match(/\A\[([^\]\n]+)\]\(([^)\s\n]+)\)\z/))
+      text.split(/(\[[^\n\]]+\]\([^)\s]+\))/).map do |part|
+        if (match = part.match(/\A\[([^\n\]]+)\]\(([^)\s]+)\)\z/))
           "#{colorize(match[1], :cyan, enabled: enabled)} (#{colorize(match[2], :dim, enabled: enabled)})"
         else
           inline_emphasis(part, enabled: enabled)

data/lib/kward/auth/anthropic_oauth.rb

@@ -202,8 +202,8 @@ module Kward
       parse_successful_json(response, "Anthropic OAuth token exchange")
     end
 
-    def post_json(uri, params)
-      super(uri, params, headers: { "Accept" => "application/json" })
+    def post_json(uri, params = nil, **keyword_params)
+      super(uri, params, headers: { "Accept" => "application/json" }, **keyword_params)
     end
   end
 end

data/lib/kward/auth/github_oauth.rb

@@ -4,6 +4,7 @@ require "time"
 require "uri"
 require_relative "file"
 require_relative "../config_files"
+require_relative "../http"
 
 # Namespace for the Kward CLI agent runtime.
 module Kward
@@ -15,7 +16,6 @@ module Kward
     DEFAULT_SCOPE = "read:user"
     DEFAULT_CLIENT_ID = "Iv1.b507a08c87ecfe98"
     COPILOT_HEADERS = {
-      "User-Agent" => "GitHubCopilotChat/0.35.0",
       "Editor-Version" => "vscode/1.107.0",
       "Editor-Plugin-Version" => "copilot-chat/0.35.0",
       "Copilot-Integration-Id" => "vscode-chat"
@@ -150,7 +150,7 @@ module Kward
     end
 
     def post_form(uri, params)
-      request = Net::HTTP::Post.new(uri)
+      request = Http.apply_user_agent(Net::HTTP::Post.new(uri))
       request["Content-Type"] = "application/x-www-form-urlencoded"
       request["Accept"] = "application/json"
       request.body = URI.encode_www_form(params)
@@ -160,7 +160,7 @@ module Kward
     end
 
     def get_json(uri, headers = {})
-      request = Net::HTTP::Get.new(uri)
+      request = Http.apply_user_agent(Net::HTTP::Get.new(uri))
       request["Accept"] = "application/json"
       COPILOT_HEADERS.merge(headers).each { |key, value| request[key] = value }
 

data/lib/kward/auth/oauth_helpers.rb

@@ -6,6 +6,7 @@ require "securerandom"
 require "socket"
 require "time"
 require "uri"
+require_relative "../http"
 
 # Namespace for the Kward CLI agent runtime.
 module Kward
@@ -58,8 +59,9 @@ module Kward
       socket&.close
     end
 
-    def post_json(uri, params, headers: {})
-      request = Net::HTTP::Post.new(uri)
+    def post_json(uri, params = nil, headers: {}, **keyword_params)
+      params = (params || {}).merge(keyword_params)
+      request = Http.apply_user_agent(Net::HTTP::Post.new(uri))
       request["Content-Type"] = "application/json"
       headers.each { |key, value| request[key] = value }
       request.body = JSON.dump(params)

data/lib/kward/auth/openai_oauth.rb

@@ -5,6 +5,7 @@ require "time"
 require "uri"
 require_relative "file"
 require_relative "oauth_helpers"
+require_relative "../http"
 
 # Namespace for the Kward CLI agent runtime.
 module Kward
@@ -215,7 +216,7 @@ module Kward
     end
 
     def post_form(uri, params)
-      request = Net::HTTP::Post.new(uri)
+      request = Http.apply_user_agent(Net::HTTP::Post.new(uri))
       request["Content-Type"] = "application/x-www-form-urlencoded"
       request.body = URI.encode_www_form(params)
 

data/lib/kward/cancellation.rb

@@ -2,9 +2,9 @@ require "thread"
 
 # Namespace for the Kward CLI agent runtime.
 module Kward
-  # Cooperative cancellation token shared by model calls, tools, and workers.
+  # Cooperative cancellation token shared by model calls, tools, and background operations.
   class Cancellation
-    # Cooperative cancellation token shared by model calls, tools, and workers.
+    # Cooperative cancellation token shared by model calls, tools, and background operations.
     class CancelledError < StandardError; end
 
     def initialize

data/lib/kward/cli/commands.rb

@@ -156,7 +156,7 @@ module Kward
           },
           "pan" => {
             usage: "kward pan",
-            description: "Start Pan mode, a minimal LAN web UI with a prompt textarea and transcript.",
+            description: "Start Pan mode, a mobile-friendly LAN web UI with persistent sessions.",
             examples: ["kward pan", "kward --working-directory ~/code/project pan"]
           },
           "rpc" => {
@@ -220,8 +220,6 @@ module Kward
             @prompt_delimited = true
             remaining.concat(arguments[(index + 1)..] || [])
             break
-          when "--experimental-workers"
-            @experimental_workers = true
           when "--skip-config"
             @skip_config = true
           when "--filter"

data/lib/kward/cli/interactive_turn.rb

@@ -7,7 +7,6 @@ module Kward
       private
 
       def run_interactive_turn(agent, input, display_input: nil)
-        stop_live_worker_view if respond_to?(:stop_live_worker_view, true)
         prepare_memory_context(agent.conversation, input) if agent.respond_to?(:conversation)
         print_user_transcript(input, display_input: display_input) if prompt_interface?
         return run_blocking_interactive_turn(agent, input, display_input: display_input) unless prompt_interface?
@@ -235,22 +234,6 @@ module Kward
         ["/exit", "/quit", "/new"].include?(input.to_s.strip)
       end
 
-      def handle_busy_worker_input(input, agent, queued_inputs)
-        return false unless agent
-
-        command = input.to_s.strip
-        return false unless command == "/workers" || command.start_with?("/workers ")
-
-        _handled, replacement_agent = handle_local_slash_command(command, agent, @session_store)
-        @busy_replacement_agent = replacement_agent if replacement_agent?(replacement_agent)
-        restore_busy_input_prompt
-        true
-      rescue StandardError => e
-        runtime_output("Error: #{e.message}")
-        restore_busy_input_prompt
-        true
-      end
-
       def replacement_agent?(object)
         object.respond_to?(:conversation) && object.respond_to?(:ask)
       end

data/lib/kward/cli/plugins.rb

@@ -32,6 +32,7 @@ module Kward
 
       def reload_plugins(conversation)
         @plugin_registry = PluginRegistry.load(reserved_commands: reserved_slash_command_names)
+        @prompt.update_slash_commands(slash_command_entries) if @prompt.respond_to?(:update_slash_commands)
         conversation.plugin_registry = @plugin_registry if conversation.respond_to?(:plugin_registry=)
         conversation.refresh_system_message! if conversation.respond_to?(:refresh_system_message!)
         runtime_output("Plugins reloaded.")
@@ -101,6 +102,17 @@ module Kward
         end
       end
 
+      def update_plugin_tab_slash_commands(tab)
+        return unless @prompt.respond_to?(:update_slash_commands)
+
+        entries = if tab&.driver&.respond_to?(:slash_command_entries)
+          tab.driver.slash_command_entries
+        else
+          []
+        end
+        @prompt.update_slash_commands(slash_command_entries + Array(entries))
+      end
+
       def slash_command_entries
         prompt_entries = prompt_templates.map do |template|
           {
@@ -126,19 +138,13 @@ module Kward
       end
 
       def builtin_slash_commands
-        return BUILTIN_SLASH_COMMANDS if experimental_workers_enabled?
-
-        BUILTIN_SLASH_COMMANDS.reject { |command| %w[workers queue].include?(command[:name]) }
+        BUILTIN_SLASH_COMMANDS
       end
 
       def builtin_slash_command_names
         builtin_slash_commands.map { |command| command[:name] }
       end
 
-      def experimental_workers_enabled?
-        @experimental_workers == true
-      end
-
       def expand_prompt_template(input)
         PromptCommands.expand(input, templates: prompt_templates, reserved_commands: builtin_slash_command_names)
       end
@@ -197,6 +203,17 @@ module Kward
         plugin_registry.notify_transcript_event(event, plugin_context(conversation, ""))
       end
 
+      def notify_plugin_tab_transcript_event(event, driver)
+        return if plugin_registry.transcript_event_handlers.empty?
+
+        context = PluginRegistry::Context.new(
+          conversation: driver,
+          workspace_root: current_workspace_root,
+          say_callback: lambda { |message| runtime_output(message) }
+        )
+        plugin_registry.notify_transcript_event(event, context)
+      end
+
     end
   end
 end

data/lib/kward/cli/prompt_interface.rb

@@ -18,6 +18,7 @@ module Kward
         @prompt = prompt_interface.new(
           slash_commands: slash_command_entries,
           overlay_settings: ConfigFiles.overlay_settings,
+          project_browser_icon_theme: ConfigFiles.project_browser_icon_theme,
           footer: prompt_footer_renderer,
           composer_status: method(:composer_status_text),
           busy_help: ConfigFiles.composer_busy_help?,

data/lib/kward/cli/rendering.rb

@@ -7,9 +7,15 @@ module Kward
       private
 
       def render_conversation_transcript(conversation)
+        render_transcript_messages(conversation.messages)
+      end
+
+      # Renders a transcript supplied by either a Kward conversation or a
+      # plugin-owned tab driver.
+      def render_transcript_messages(messages)
         tool_calls_by_id = {}
         @prompt.say("\n#{colored("Transcript", :gray, :bold)}\n")
-        conversation.messages.each do |message|
+        Array(messages).each do |message|
           role = message_role(message)
           next if role == "system"
 

data/lib/kward/cli/runtime_helpers.rb

@@ -43,23 +43,14 @@ module Kward
       end
 
       def build_interactive_agent(conversation)
-        @active_worker_role = "implementation"
-        set_visible_worker("implementation", status: "active")
-        build_worker_agent(conversation, role: "implementation")
-      end
-
-      def build_worker_agent(conversation, role: "implementation")
         conversation.plugin_registry ||= plugin_registry if conversation.respond_to?(:plugin_registry)
         workspace = configured_workspace(root: conversation.workspace_root)
-        writer_id = worker_writer_id(role)
         hook_manager = lifecycle_hook_manager(conversation)
         hook_context = lifecycle_hook_context(conversation)
         tool_registry = ToolRegistry.new(
           workspace: workspace,
           prompt: @prompt,
-          allowed_tool_names: Workers::ToolPolicy.allowed_tool_names(role),
-          write_lock: @worker_write_lock,
-          writer_id: writer_id,
+          tool_approval: interactive_tool_approval_callback,
           hook_manager: hook_manager,
           hook_context: hook_context
         )
@@ -74,32 +65,17 @@ module Kward
         )
       end
 
-      def set_visible_worker(id, status: nil, worker: nil)
-        @visible_worker_id = id.to_s
-        @visible_worker_status = status
-        @visible_worker = worker
-      end
-
-      def worker_writer_id(role)
-        return nil unless Workers::ToolPolicy.write_capable?(role)
-
-        @worker_write_lock ||= Workers::WriteLock.new
-        owner_id = role.to_s.empty? ? "implementation" : role.to_s
-        return owner_id if @worker_write_lock.acquire(owner_id)
+      def interactive_tool_approval_callback
+        return nil unless @prompt.respond_to?(:ask_tool_approval)
+        return nil unless ConfigFiles.permission_policy(safely_read_config.to_h).enabled?
 
-        nil
-      end
-
-      def refresh_implementation_writer(agent)
-        return agent unless @active_worker_role == "implementation"
-        return agent unless agent&.respond_to?(:tool_registry)
-        return agent if agent.tool_registry.writer_id && @worker_write_lock&.owned_by?(agent.tool_registry.writer_id)
-
-        build_interactive_agent(agent.conversation)
-      end
-
-      def release_implementation_writer
-        @worker_write_lock&.release("implementation")
+        lambda do |tool_call:, name:, args:, cancellation:|
+          @prompt.ask_tool_approval(
+            tool_name: name,
+            args: args,
+            reason: args["hook_message"] || args[:hook_message]
+          )
+        end
       end
 
       def handle_interactive_shell_command(input, agent)

data/lib/kward/cli/sessions.rb

@@ -80,6 +80,15 @@ module Kward
         @cleanup_sessions.clear
       end
 
+      def live_session_paths
+        (Array(@tabs).filter_map { |tab| tab.session&.path } + [@active_session&.path]).compact.uniq
+      end
+
+      def recent_sessions(session_store, tree: false, limit: nil)
+        method = tree ? :recent_tree : :recent
+        session_store.public_send(method, limit: limit, keep_empty_path: live_session_paths)
+      end
+
       def cleanup_replaced_session(previous_session)
         return unless previous_session
         return if @active_session && File.expand_path(previous_session.path) == File.expand_path(@active_session.path)
@@ -590,8 +599,8 @@ module Kward
       end
 
       def insert_session_copy(session_store, sessions, labels, source, copy_path)
-        copy_info = session_store.recent_tree(limit: nil).find { |session| File.expand_path(session.path) == File.expand_path(copy_path) }
-        copy_info ||= session_store.recent(limit: nil).find { |session| File.expand_path(session.path) == File.expand_path(copy_path) }
+        copy_info = recent_sessions(session_store, tree: true).find { |session| File.expand_path(session.path) == File.expand_path(copy_path) }
+        copy_info ||= recent_sessions(session_store).find { |session| File.expand_path(session.path) == File.expand_path(copy_path) }
         return nil unless copy_info
 
         source_index = sessions.index(source) || 0
@@ -618,7 +627,7 @@ module Kward
         return nil unless source
 
         session_store.load(source.path).first.rename(name)
-        updated = session_store.recent_tree(limit: nil)
+        updated = recent_sessions(session_store, tree: true)
         sessions.replace(updated)
         labels.replace(session_picker_labels(sessions))
         index = sessions.index { |session| File.expand_path(session.path) == File.expand_path(source.path) } || 0
@@ -716,7 +725,7 @@ module Kward
       end
 
       def select_session_path(session_store)
-        select_session_path_from_sessions(session_store.recent_tree(limit: nil), session_store: session_store)
+        select_session_path_from_sessions(recent_sessions(session_store, tree: true), session_store: session_store)
       end
 
       def reopen_sessions_after_fork(session_store, source_path, source_label)
@@ -724,7 +733,7 @@ module Kward
           fork_session_from_picker(session_store, source_path)
         end
 
-        sessions = session_store.recent_tree(limit: nil)
+        sessions = recent_sessions(session_store, tree: true)
         labels = session_picker_labels(sessions)
         initial_index = if fork_path
                           sessions.index { |session| File.expand_path(session.path) == File.expand_path(fork_path) }

data/lib/kward/cli/settings.rb

@@ -243,6 +243,8 @@ module Kward
             next unless width
 
             update_overlay_settings("width" => width)
+          when /\Afile icons/
+            configure_project_browser_icon_theme
           when /\Ashow busy help/, /\Ahide busy help/
             set_composer_busy_help(!composer_busy_help?)
             runtime_output("Busy help #{composer_busy_help? ? "enabled" : "disabled"}. Restart the TUI to apply this setting.")
@@ -277,6 +279,7 @@ module Kward
         [
           "Overlay alignment (#{settings["alignment"]})",
           "Overlay width (#{settings["width"]})",
+          "File icons (#{project_browser_icon_theme})",
           "#{composer_busy_help? ? "Hide" : "Show"} busy help (currently #{on_off(composer_busy_help?)})",
           "Tab keybindings (#{composer_tab_keybindings})",
           "Editor mode (#{editor_mode})",
@@ -290,6 +293,25 @@ module Kward
         ]
       end
 
+      def project_browser_icon_theme
+        ConfigFiles.project_browser_icon_theme(safely_read_config.to_h)
+      end
+
+      def configure_project_browser_icon_theme
+        selected = @prompt.select("File icons", project_browser_icon_theme_choices, title: "Settings")
+        theme = selected.to_s.split.first.to_s.downcase
+        return unless ConfigFiles::PROJECT_BROWSER_ICON_THEMES.include?(theme)
+
+        update_nested_config("project_browser", "icons" => theme)
+        @prompt.update_project_browser_icon_theme(theme) if @prompt.respond_to?(:update_project_browser_icon_theme)
+        runtime_output("File icons set to #{theme}.")
+      end
+
+      def project_browser_icon_theme_choices
+        current = project_browser_icon_theme
+        ConfigFiles::PROJECT_BROWSER_ICON_THEMES.map { |theme| theme == current ? "#{theme} (current)" : theme }
+      end
+
       def composer_busy_help?
         ConfigFiles.composer_busy_help?(safely_read_config.to_h)
       end