filepeek logo

Your AI agent wrote 200 files.
Stop reading them in a terminal.

filepeek is a free, self-hosted browser that renders the Markdown, Mermaid, Excel, Word, HTML, images, and code your agents produce — Claude Code, ChatGPT, Cursor, anything — straight from your local filesystem.

Get it on GitHub Quick start

MIT licensed Python 3.10+ No database 100% self-hosted

▶ 78-second narrated tour

Made for AI coding-agent output

Claude Code, ChatGPT, Cursor, or any coding agent just wrote a pile of .md, .html, and .xlsx files into your WSL2 or Linux filesystem — and you're squinting at raw markdown in a terminal. filepeek serves any directory as a browsable web UI that renders what agents produce, the way it was meant to look.

Claude Code · ChatGPT · Cursor → files on your disk → filepeek → your browser

Why not just open them in VS Code?

VS Code shows you source. filepeek shows you the result — the rendered page your agent meant for a human to read.

In your editorIn filepeek
Raw Markdown sourceRendered Markdown
Mermaid as textRendered diagrams
Excel needs an extensionOpens directly, sheet by sheet
HTML as sourceInteractive, clickable page
Hard to share a viewA URL for every file
Tied to your desktopWorks from any browser, including mobile

What it renders

📝 Markdown + Mermaid

AI-written docs, plans, and reports rendered with tables, code blocks, and Mermaid diagrams.

📊 Excel, Word, PowerPoint

View xlsx, docx, and pptx in the browser — no Microsoft Office, no LibreOffice, no upload.

🌐 HTML pages

Agent-built dashboards and mockups served directly, ready to click through.

💻 Code & data

~60 languages, CSV/TSV as sortable tables, SVG, and PDFs inline.

🖼️ Images, video & audio

View PNG/JPG/GIF/WebP, play mp4/webm/mov video and mp3/wav audio — inline, no download.

🔍 Search & organize

Filename and full-text search, bookmarks, and a bookmarkable URL for every folder and file.

🔐 Self-hosted & private

Your files never leave your machine. Optional HTTPS + password mode for cloud servers and Tailscale.

☁️ Cloud drives too

Browse OneDrive, SharePoint, or Google Drive as a folder — step-by-step setup guide for WSL2, Linux, and cloud VMs.

See it in action

filepeek file browser: a folder tree and file list with inline previews
Browse any folder — tree, list, and inline previews, with a bookmarkable URL for every file
Markdown document with a rendered Mermaid architecture diagram
Markdown with Mermaid diagrams
Excel workbook rendered as styled tables in the browser
xlsx rendered, sheet by sheet
HTML dashboard served directly inside filepeek
HTML reports open as pages
Full-text search results across file names and contents
Search names and contents

Bonus

🗂️ Organize work with built-in task boards

Already pointing filepeek at your project? Any .nts file opens as an interactive task board — kanban, table, and bugs views with owners, labels, priorities, and checklists. The board is plain JSON saved back to the file: versionable, portable, no database.

Tracks task board: kanban columns of cards with priorities, owners, labels, checklist progress, and bug counts
Track boards — kanban, table & bugs views, saved as a plain .nts file

Bonus

☁️ Protect files with built-in backup

Back up chosen folders (or everything) to a local/NAS path or any S3-compatible cloud — Backblaze B2, Wasabi, Cloudflare R2, AWS — on a schedule or on demand. Cloud setup is four pasted values. Copy mode never deletes; an advanced mirror mode is gated behind a preview and a typed confirmation.

Quick start

git clone https://github.com/thrinz/filepeek && cd filepeek
./install.sh
FILEPEEK_ROOT=~/projects .venv/bin/python app.py

Open http://localhost:8765. On WSL2 that URL works directly in your Windows browser. One Python file, one HTML file, no database. Need a different port? Set FILEPEEK_PORT=9000 (or pass --port 9000). Want it always on? ./install.sh --service installs a systemd user service that auto-starts on boot.

Frequently asked questions

How do I view the Markdown files Claude Code or ChatGPT generates?

Point filepeek at the folder your agent writes to (FILEPEEK_ROOT=~/projects) and open localhost:8765 — every Markdown file renders with formatting, tables, code blocks, and Mermaid diagrams instead of raw text.

Can I open xlsx, docx, or pptx files without Microsoft Office?

Yes. filepeek renders Excel workbooks (per-sheet tables), Word documents, and PowerPoint slides directly in the browser using pure Python.

Does it work on WSL2?

That's the home turf — run it inside WSL2 and open localhost:8765 in your Windows browser. Localhost forwarding is automatic.

Is my data sent anywhere?

No. filepeek is fully self-hosted and reads files straight off your disk.

Can it show my OneDrive, SharePoint, or Google Drive files?

Yes — make the drive appear as a local folder and point FILEPEEK_ROOT at it. On WSL2 the Windows sync clients you already have are enough (/mnt/c/Users/you/OneDrive); on Linux or a cloud VM, an rclone mount or the abraunegg onedrive client does it — SharePoint document libraries included. The cloud drives guide has copy-paste setup for all three.

Can filepeek back up my files?

Yes — built in. Back up selected folders (or everything) to a local/NAS folder or any S3-compatible cloud (AWS, Backblaze B2, Wasabi, Cloudflare R2, MinIO) on a schedule or on demand. Cloud setup is four pasted values — no provider console app. Copy mode never deletes; an advanced mirror mode is gated behind a preview and a typed confirmation.

What are Track boards (.nts files)?

Any .nts file opens as an interactive task board — kanban, table, and bugs views with owners, labels, priorities, checklists, and per-task bug tracking. The board is plain JSON saved back to the file, so it's versionable and portable, with no database.

Is it free?

Yes — free and open source under the MIT license.