App Workflows
Repository-aware workflows for setup, linking, migrations, runtime configuration, and app installation.
Polter keeps generic Supabase execution separate from app-specific automation. Use the app namespace when you want project-aware workflows:
polter app <action> <target> [options]setup ops
Full source-checkout bootstrap: installs dependencies, collects Supabase connection data, links the project, pushes migrations, and writes the runtime bootstrap payload used by the desktop app.
polter app setup ops --path .The --path flag points to the root of the Ops source checkout.
link ops
Link or relink the checkout to the intended Supabase project.
polter app link ops --path .migrate ops
Push pending migrations to the linked Supabase project. Supports subcommands:
polter app migrate ops push --path .Available migrate subcommands:
| Subcommand | Description |
|---|---|
push | Push pending migrations to the linked project |
lint | Lint migration files |
reset | Reset remote database and replay migrations |
local-reset | Reset local database and replay migrations |
configure ops
Refresh the runtime connection payload without reinstalling the app.
polter app configure ops --path .Use this when you need to update connection details without going through the full setup flow.
install ops
Install the packaged macOS app from GitHub Releases and prepare the runtime Supabase connection.
polter app install opsCurrently macOS-only. By default it resolves the latest GitHub release from polterware/ops.
Options
| Option | Description |
|---|---|
--version <version> | Pin a specific release version |
--artifact-url <url> | Manual override for the download URL |
Environment Variables
| Variable | Description |
|---|---|
POLTER_OPS_MACOS_ARTIFACT_URL | Manual override for the macOS artifact URL |
POLTER_OPS_GITHUB_REPO | Resolve releases from a fork or different repository (format: owner/repo) |
Install a specific release:
polter app install ops --version 1.0.0update ops
Replace the installed ops.app with a newer release while preserving the persisted runtime configuration, local settings, and Supabase session state stored outside the app bundle.
polter app update opsAlso macOS-only. Use POLTER_OPS_GITHUB_REPO=owner/repo when you need to resolve releases from a fork or a different repository.