Skip to content

File Editor

ClaudeControl includes a built-in file editor and viewer for working with project files.

File Tree

The sidebar shows the project's file structure. Files are organized by directory with icons for common file types. The tree auto-refreshes and filters out:

  • node_modules, dist, .git, __pycache__
  • .next, .nuxt, coverage, .vite, .cache

Click a file to open it in the editor panel.

File Editor

  • Syntax highlighting for TypeScript, JavaScript, Python, Markdown, and more
  • Save button to write changes back to disk
  • Line numbers
  • Files larger than 50KB are truncated with a warning

Git Diff View

Click the diff icon on an open file to see a side-by-side comparison:

  • Old content from git show HEAD:file
  • New content from disk
  • Red/green highlighting for changes

Inline Diffs in Chat

When an agent uses the Edit tool, the chat shows an inline diff:

  • Red line-through: removed text
  • Green: added text

This makes it easy to see what the agent changed without opening the file editor.

File Attachments

Send files to agents as part of a message:

  • Images: PNG, JPEG, GIF, WebP
  • Documents: PDF, TXT, MD, CSV

Storage

Attachments are saved to disk at:

~/.claudecontrol/data/{workspaceId}/attachments/{agentId}-{timestamp}-{index}.{ext}

The chat log stores only a filePath reference (not the full base64 data), keeping logs lightweight. Files are served via HTTP with immutable caching.

Git Status

The sidebar shows git repository status:

  • Current branch name
  • Clean/dirty indicator
  • Changed files list (modified, new, deleted)
  • Last 5 commit messages
  • Monorepo support (detects sub-repos)

Released under the MIT License.