File Links Plugin

The file_links plugin makes files the agent generates or modifies discoverable, previewable, and downloadable from the web UI. It also lets users browse the configured repos_dir and inspect what changed during a conversation.

Overview

Surface	Where	What it does
x-file-links-card	Transcript, per plugin.file_links.file_written event	Shows filename, size, file kind, Download + Open in browser
x-file-links-header-button	Chat header ("Files")	Entry point to the repo browser
x-file-links-browser	Page at /plugins/file_links/repos	Repo tree + preview; This conversation ↔ All files toggle

The plugin subscribes to onToolInvokeEnd and tracks writes from configurable tools (default: write_file, replace_in_file, doc_save, client_fs_copy_from_repo). Tracked paths are stored per conversation and surfaced via UI events and API routes under /ui/plugins/file_links/.

Configuration

plugins:
  - module: codumentor.plugins.file_links
    class: FileLinksPlugin
    args:
      enabled: true
      # tracked_tools: ["write_file", "replace_in_file", "doc_save"]

Parameters

• enabled (optional): Whether the plugin is active (default: true)
• tracked_tools (optional): Tool names whose writes are tracked. Defaults to the built-in allow-list when omitted.

Disabling

To turn the plugin off without removing it from the plugins list:

plugins:
  - module: codumentor.plugins.file_links
    class: FileLinksPlugin
    args:
      enabled: false

Or remove its entry from the plugins list entirely. The doc_editor download endpoint redirects to file_links when both are present.

See also

• File Links developer guide — tracker internals, routes, isolation notes
• UI Components — custom elements and placements