Skip to content
Get packs

Run Dozzle Dev Instance

Start a local Dozzle dev server on a worktree-specific free port for hands-on UI testing

Source Download skill
Repository
amir20/dozzle
Stars
14,785
Licence
MIT
Files
1 file

What it does

When an agent needs to test a Dozzle change by actually using the web interface, this skill tells it how to start its own Dozzle development server on a port unique to the current code checkout, so several copies of the project can run at once without clashing. It explains how to wait until the server is ready, how to drive the page with Chrome or Playwright, and how to stop only the server it started.

Great for

  • Contributors to the Dozzle project working on UI changes who want an agent to verify them in a browser
  • Developers running several git worktrees of the same repository at the same time

Skip it if

  • People who just want to use Dozzle to view container logs; this is for developing Dozzle itself, not running a production install
  • Environments without the Dozzle repository, Go, Bun or Docker available, since the skill starts local build and dev tooling

Try asking

  • “Start a Dozzle dev instance for this worktree and check that my new log filter works in the browser”
  • “Run the production build on my port and take screenshots of the settings page”
  • “Use Playwright to simulate a broken clipboard and confirm the copy button shows an error”
Step-by-step guide: how to use Run Dozzle Dev InstanceInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    run-dev-instance.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip run-dev-instance.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip run-dev-instance.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask the agent for the URL first, since it is derived from the checkout path and stays the same for that worktree.
  • Use the one-shot production build for checking already-written code; use make dev-auto when iterating with hot reload.
  • Review the commands it plans to run, since it starts background processes and can kill the process listening on its own port.

What's inside

  • SKILL.md

Redistributed unmodified from amir20/dozzle under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.