Claude-skill-registry local-dev

Start local development environment with backend and macOS app

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/local-dev" ~/.claude/skills/majiayu000-claude-skill-registry-local-dev && rm -rf "$T"
manifest: skills/data/local-dev/SKILL.md
source content

Start Local Development Environment

Start the backend server and macOS app for local development.

Usage

Run

/local-dev
to start both the backend and app, or:

  • /local-dev backend
    - start backend only
  • /local-dev app
    - build and run the macOS app (debug mode)
  • /local-dev app --clean
    - clean build and run (forces Swift recompilation)
  • /local-dev app --release
    - build and run in release mode

Commands

Backend

cd backend
lsof -ti:8000 | xargs kill -9 2>/dev/null || true
python3 -c "from dotenv import load_dotenv; load_dotenv(); import subprocess; subprocess.run(['python3', '-m', 'uvicorn', 'main:app', '--host', '0.0.0.0', '--port', '8000', '--reload'])"

App

app/scripts/dev-macos.sh $EXTRA_ARGS

Where

$EXTRA_ARGS
can be:

  • --clean
    - force clean build (removes build cache, ensures Swift recompilation)
  • --release
    - build in release mode instead of debug
  • --no-run
    - build only, don't launch the app

Argument Handling

When

$ARGUMENTS
is "backend", only start the backend. When
$ARGUMENTS
is "app", build and run the macOS app. When
$ARGUMENTS
starts with "app ", pass remaining args to the script (e.g., "app --clean"). When
$ARGUMENTS
is empty or "all", start both backend and app.