Skip to content

mriziq/popopen

Repository files navigation

Popopen

A visual UI for browsing, editing, and managing coding agent skills.
Anywhere, anytime — just run popopen.

npm version npm downloads License: ISC Node.js ≥18


Install

npm install -g popopen

Requirements: Node.js 18+

Usage

popopen

That's it. Run it from any directory, any time — Popopen opens in your browser instantly. If it's already running, it just pops the tab back up. No setup, no config, no arguments required.

PORT=4000 popopen   # use a different port

Features

  • Browse & edit skills — view all installed and custom skills, edit markdown files with live preview
  • Frontmatter editor — toggle skill settings (disable-model-invocation, descriptions, etc.) without touching raw YAML
  • Search — full-text search across all skill files
  • Dashboard — usage analytics (views, edits, saves) tracked locally
  • Version history — per-skill git log and the ability to initialize git tracking on any skill
  • Bulk operations — batch toggle frontmatter fields, export skills as a ZIP
  • Update checker — compares installed skill folder hashes against their GitHub source and applies updates via the Claude Code CLI
  • Uninstall — remove installed or custom skills from the UI

How it works

Popopen is a local Express server that reads from ~/.claude/skills/ (custom skills) and ~/.agents/skills/ (agent-installed skills). It works with any coding agent that follows the skills convention. All data stays on your machine — nothing is sent to any external service except GitHub API calls for the update checker.

The server binds to 127.0.0.1 only and is not accessible from other machines on your network.

Analytics are stored in ~/.popopen/analytics.json.

Local Development

git clone https://github.com/mriziq/popopen.git
cd popopen
npm install
npm run dev

Starts the Express server at http://localhost:3377. Refresh the browser to pick up UI changes during development.

To test against a different skills directory:

SKILLS_DIR=~/my-test-skills npm run dev

The entry point is server/index.js. Static assets are served from public/. All routes live under server/routes/.

Uninstall

npm uninstall -g popopen

Built for coding agents · Changelog · Contributing

About

Open your coding agent and examine its skills.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors