filepeek logo

View AI-generated files in your browser

filepeek is a free, self-hosted web viewer for the files AI agents produce — Markdown, HTML, Excel, Word, PowerPoint, CSV, code, images, and PDFs — rendered, not raw.

Get it on GitHub Quick start

▶ 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.

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, images, SVG, and PDFs inline.

🔍 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.

See it in action

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

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.

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.

Is it free?

Yes — free and open source under the MIT license.