local dev
- Repo stars 330
- License MIT
- Author repo claude-skill-registry
- Domain
- Data
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 94 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @majiayu000 · MIT
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- macOS
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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
```bash
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
```bash
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.
Sections and files
Listed in source order.
sections -> Usage → Commands → Backend → App → Argument Handling
terms -> Start the backend server and macOS app for local development. · When $ARGUMENTS is "backend", only start the backend.
files/cmd -> /local-dev · /local-dev backend · /local-dev app · /local-dev app --clean · /local-dev app --release · $EXTRA_ARGS · --clean · --release
body sha256 -> d155bbeda4a1
Usage
Run
/local-devto 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 modeApp
Where
$EXTRA_ARGScan 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 appArgument Handling
When
$ARGUMENTSis "backend", only start the backend. When$ARGUMENTSis "app", build and run the macOS app. When$ARGUMENTSstarts with "app ", pass remaining args to the script (e.g., "app --clean"). When$ARGUMENTSis empty or "all", start both backend and app.