codebrowse

2026-03-01 Sun 12:31 article code python tool

Intro

20260301-134132-bacc43fefdf12167.jpg
20260301-134132-fea747b515c0bc3c.jpg

codebrowse is a single-file code browser I coaxed shelley into building for me to add to my exe.dev projects.

  • single file Flask app
  • Pygments for syntax highlighting
  • HTMX for interaction
  • mobile friendly tree file browser

Why I made it

After doing a lot of casual hacking on exe.dev from my phone through shelley, I wanted a simple way to browse what was being generated.

A way to read the files, check the structure, check the layout of the project.

Running

uvx codebrowse --root /path/to/code --port 8001

Using on exe.dev

It's extremely easy to coax Shelley into setting it up for a specific dir and port.

20260301-134120-923bea188698ae0d.jpg

Use a prompt such as:

Put this on port 6767 for <???> dir

https://github.com/minikomi/codebrowse

Available Options

  • --root, -r : root directory to browse (env: FB_ROOT, default: .)
  • --port, -p : server port (env: FB_PORT, default: 8000)
  • --title, -t : page title (env: FB_TITLE, default: File Browser)
  • --ignore, -i : extra dirs to ignore, comma-separated (env: FB_IGNORE)