🎯

local-dev

🎯Skill

from basedhardware/omi

What it does

Launches local development environment by starting backend server and macOS app with flexible configuration options.

📦

Part of

basedhardware/omi(16 items)

local-dev

Installation

git cloneClone repository

git clone https://github.com/BasedHardware/omi.git

📖 Extracted from docs: basedhardware/omi

Need more details? View full documentation on GitHub →

2Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Start local development environment with backend and macOS app

Overview

# 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.

More from this repository10

🎯

agent-modes🎯Skill

Skill

🎯

omi-backend-patterns🎯Skill

Provides reusable backend architectural patterns and design templates for implementing scalable and efficient server-side components within the Omi AI wearable project.

🎯

omi-flutter-patterns🎯Skill

Provides reusable Flutter design patterns and UI components specifically tailored for the Omi wearable device's mobile application interface.

🎯

pr-automation🎯Skill

Automatically creates, reviews, and manages pull requests by analyzing code changes and generating descriptive summaries and potential improvements.

🎯

self-improvement🎯Skill

Skill

🎯

omi-plugin-development🎯Skill

Enables developers to create custom plugins and extensions for the Omi AI wearable device, providing a framework for adding new functionality and integrations.

🎯

agent-review🎯Skill

Reviews and provides feedback on AI agent performance, helping developers assess and improve their AI agent's capabilities and interactions.

🎯

omi-firmware-patterns🎯Skill

Generates and manages firmware design patterns and architectural templates for the Omi wearable device's embedded system development.

🎯

issue-triage🎯Skill

Automatically categorizes, prioritizes, and assigns GitHub issues based on their content and project context to streamline repository management.

🎯

context-optimization🎯Skill

Optimizes conversation context for AI processing by dynamically filtering, summarizing, and prioritizing relevant conversational details to improve AI comprehension and response accuracy.