local-dev
- Repo stars 330
- License MIT
- Author repo claude-skill-registry
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.
- Fluxly category
- 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
- Author / version / license
- @majiayu000 · MIT
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Guided setup
- External API key
- No requirement detected
- Detected OS requirements
- macOS
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Shell exec
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. 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)
Commands
Backend
Where $EXTRAARGS can be: --clean - force clean build (removes build cache, ensures Swift recompilation) --release - build in release mode instead of debug
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").
# 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. Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
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 · $EXTRAARGS · --clean · --release
body sha256 -> d155bbeda4a1
Decide Fit First
Design Intent
How To Use It
Boundaries And Review