CLI Reference

Nib provides a command-line interface with three commands for the full development lifecycle of a macOS menu bar application.

Command Description
nib create Scaffold a new project with standard structure
nib run Run your app in development mode with hot reload
nib build Build a standalone .app bundle for distribution

nib run and nib build accept -v / --verbose (twice for debug output). nib --version prints the installed version.

Configuration

Commands read defaults from pyproject.toml when present. See the pyproject.toml configuration reference for all available options.

Quick start

nib create my-app        # Scaffold a new project
cd my_app
nib run                  # Run with hot reload (reads entry from pyproject.toml)
nib build                # Build standalone .app bundle