Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
384ca97
feat(file-preview): add markdown workspace editing
edgarsskore Mar 24, 2026
fc40ddd
fix(file-preview): remove gap below short markdown previews, tune con…
edgarsskore Mar 27, 2026
8186579
Merge branch 'main' into feat/md-document-editor
edgarsskore Apr 7, 2026
cf10d0e
fix(file-preview): make markdown links clickable in edit mode and sto…
edgarsskore Apr 7, 2026
670ea79
chore: drop unrelated package-lock churn
edgarsskore Apr 8, 2026
ee0f9b1
refactor(file-preview): restructure markdown editor, fix toolbar cons…
edgarsskore Apr 9, 2026
4738477
revert: restore README.md to pre-edit state
edgarsskore Apr 9, 2026
992a733
docs: document File Preview UI and markdown editor in README
wonderwhy-er Apr 14, 2026
4c4f474
docs: add Directory Browser subsection to File Preview UI
wonderwhy-er Apr 14, 2026
8fd8f94
feat(file-preview): always-edit markdown, source-preserving WYSIWYG, …
edgarsskore Apr 15, 2026
5ce649b
fix(file-preview): handle Enter key directly in source, fix edit prev…
edgarsskore Apr 15, 2026
9356981
refactor(file-preview): replace contenteditable markdown editor with …
edgarsskore Apr 16, 2026
b63b0de
refactor(file-preview): clean up dead state and hot-path allocations …
edgarsskore Apr 16, 2026
724766e
fix(file-preview): skip URL-path refresh and drop redundant autosave …
edgarsskore Apr 16, 2026
ff76e25
feat(file-preview): track markdown editor usage
edgarsskore Apr 16, 2026
d960122
test(edit-block): update assertions to new preview-return contract
wonderwhy-er Apr 17, 2026
d9c15a3
fix(file-preview): detect edit_block soft-failures and reload from disk
wonderwhy-er Apr 18, 2026
b31915b
feat(file-preview): show conflict dialog when external changes are de…
wonderwhy-er Apr 18, 2026
a66f873
test(markdown-preview): add structuredContent to edit_block success m…
wonderwhy-er Apr 18, 2026
8e0b27a
Merge remote-tracking branch 'origin/main' into feat/md-document-editor
wonderwhy-er Apr 18, 2026
4dd0b36
fix(file-preview): apply each save hunk independently and report hone…
wonderwhy-er Apr 19, 2026
1d5014a
feat(file-preview): debounced autosave while typing
edgarsskore Apr 20, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 52 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ Work with code and text, run processes, and automate tasks, going far beyond oth
- [How to install](#how-to-install)
- [Getting Started](#getting-started)
- [Usage](#usage)
- [File Preview UI & Markdown Editor](#file-preview-ui--markdown-editor)
- [Handling Long-Running Commands](#handling-long-running-commands)
- [Work in Progress and TODOs](#roadmap)
- [Sponsors and Supporters](#support-desktop-commander)
Expand All @@ -54,7 +55,7 @@ Execute long-running terminal commands on your computer and manage processes thr
## Features

- **Remote AI Control** - Use Desktop Commander from ChatGPT, Claude web, and other AI services via [Remote MCP](https://mcp.desktopcommander.app)
- **File Preview UI** - Visual file previews in Claude Desktop with rendered markdown, inline images, expandable content, and quick "Open in folder" access
- **File Preview UI** - Visual file previews in Claude Desktop with rendered markdown, inline images, expandable content, built-in markdown editor, and quick "Open in folder" access
- **Enhanced terminal commands with interactive process control**
- **Execute code in memory (Python, Node.js, R) without saving files**
- **Instant data analysis - just ask to analyze CSV/JSON/Excel files**
Expand Down Expand Up @@ -694,6 +695,56 @@ Desktop Commander can be run in Docker containers for **complete isolation from
- Claude can see and analyze the actual image content
- Default 30-second timeout for URL requests

## File Preview UI & Markdown Editor

Desktop Commander includes a rich file preview widget in Claude Desktop that renders files visually as AI works with them.

### Supported file types
- **Markdown** — rendered preview with a built-in editor
- **Images** — inline display (PNG, JPEG, GIF, WebP, etc.)
- **Code files** — syntax-highlighted source view
- **HTML** — rendered preview with toggle to source view
- **Directories** — interactive tree with expand/collapse and lazy loading
- **PDF, Excel, DOCX** — native content extraction and display

### Markdown Editor

When viewing a `.md` file in Claude Desktop, you can edit it directly inside the preview panel — no need to open a separate app.

**How to use:**
1. Ask Claude to read or create a markdown file
2. Expand the file preview to fullscreen using the **⤢ Expand** button
3. The editor activates automatically in fullscreen mode
4. Edit your content with a live preview toggle, copy, undo, and save controls
5. Changes are saved back to disk; collapse to return to inline view

**Editor features:**
- Live **edit / preview toggle** — switch between raw markdown and rendered output
- **Auto-save** to disk with save status indicator
- **Undo** support to revert unsaved changes
- **Copy** button to grab the full markdown source
- **Open in editor** — launch your default markdown app directly from the panel
- Partial-file awareness — loads and merges surrounding lines when the file was only partially read
- Text selection context — select text in preview mode and the AI can reference your selection

### Directory Browser

When Claude runs `list_directory`, the result opens as an interactive file tree inside the preview panel — not just raw text output.

**Features:**
- **Expandable tree** — folders expand and collapse on click; top-level contents shown immediately
- **Lazy loading** — subfolders load on demand to keep the initial view fast
- **Large directory handling** — directories with many items show a `⚠ click to load all` button instead of overwhelming the view
- **Open in Finder/Explorer** — each folder has a quick-open button to reveal it in your file manager
- **Click to preview** — clicking any file in the tree opens it in the file preview panel directly
- **Back navigation** — after opening a file from the tree, a ← Back button returns you to the directory view

### Other preview features
- **Expand / collapse** — toggle between compact summary row and full panel
- **Open in folder** — reveal the file in Finder/Explorer with one click
- **Load more lines** — incrementally load content above or below a partial read window
- **Text selection** — highlight text in any preview; the AI can see and reference your selection

## Fuzzy Search Log Analysis (npm scripts)

The fuzzy search logging system includes convenient npm scripts for analyzing logs outside of the MCP environment:
Expand Down
Loading
Loading