claude-files-pane

Files pane for Claude Code

See what Claude reads, edits and commits, live, in a VS Code-style file tree beside your chat.

View Demo · Report Bug · Request Feature

If you find this project helpful, please consider giving it a ⭐!

About The Project

• Live card: Claude's thinking, the command it runs, the file it reads or edits
• Tree that follows Claude: opens to each file it edits, even in another project
• Touched list: files read or edited this turn or session, with lines added and removed
• Git: branch, commits ahead, changed files, ignored files dimmed
• Search with VS Code's icons, best matches first
• Works in the desktop app, VS Code and the terminal

Built With

(back to top)

Getting Started

Prerequisites

Claude Code: the desktop app, the VS Code extension or the CLI, on macOS, Linux or Windows. On Windows, Open in offers VS Code, Cursor, Windsurf, Zed and Sublime Text when their command is on the PATH, and no JetBrains IDE.

Installation

In the terminal:

claude plugin marketplace add Marius-Adam/claude-files-pane && claude plugin install files-pane@marius-adam

Or in a Claude Code session:

/plugin install files-pane --marketplace Marius-Adam/claude-files-pane

Restart Claude Code and the pane opens beside the chat.

To update or remove it later:

claude plugin marketplace update marius-adam && claude plugin update files-pane@marius-adam

claude plugin uninstall files-pane@marius-adam

(back to top)

Usage

• /files brings the pane back if you close it.
• Colours tell you what happened to a file: read purple, edited orange, uncommitted yellow, committed green.
• A file's ⋯ menu can @-mention it, copy its path, show its diff, reveal it in the tree, or open it in your editor, Finder or Explorer.

Privacy: the pane is read-only. It lists folders, runs read-only git (status, diff, rev-parse, ls-files, rev-list, show) and checks which editors are installed (on Windows, with where and by reading the editor's .cmd script). It sends nothing anywhere, writes to your prompt only on @ Mention, and opens an app only on Open in or Show in Finder (Show in Explorer on Windows).

(back to top)

Contributing

Contributions are welcome. Fork the repo and open a pull request, or open a feature request. If the pane is useful to you, a star helps others find it.

1. Fork the project
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add an amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a pull request against the staging branch

Develop

Run it from a clone, then check it before you push:

git clone https://github.com/Marius-Adam/claude-files-pane.git && cd claude-files-pane && claude --plugin-dir .

claude plugin validate . && claude plugin test .

Claude Code writes its API types into .claude-plugin/types/ the first time it loads the mod; then npx -p typescript tsc -p . --noEmit type-checks it. CI runs validation and tests on every push.

Pull requests go to staging. A release is one pull request from staging to main that bumps the version in .claude-plugin/plugin.json, merged with a merge commit, since the marketplace installs from main.

To add an icon, map a name, extension or folder in hooks/icons.ts to a vscode-icons id, then:

npm pack @iconify-json/vscode-icons && tar xzf iconify-json-vscode-icons-*.tgz && python3 scripts/gen_icons.py package/icons.json hooks/icons.ts hooks/icon-svgs.ts

Top contributors

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Support

Files pane is free. If it saves you time, you can buy me a coffee on Ko-fi.

Project link: github.com/Marius-Adam/claude-files-pane

(back to top)

Acknowledgments

• vscode-icons (MIT) for the file and folder icons
• Best-README-Template for this README's layout

(back to top)