Hyper PM
Getting started

Configuration

.hyper-pm/config.json, environment variables, and global CLI flags.

.hyper-pm/config.json

Created by init. It records choices such as:

  • Data branch name (default commonly hyper-pm-data when not overridden).
  • Remote to push the data branch (origin by default).
  • Sync mode: off disables sync --with-github; outbound and full both allow it and behave the same (see GitHub sync).
  • GitHub repository slug when not passed only via environment or flags.

Prefer editing through hyper-pm init and documented flags rather than hand-editing, so invariants stay consistent.

Environment variables

Documented in apps/hyper-pm/env.example. Commonly used:

VariablePurpose
GITHUB_REPODefault owner/repo for sync and URL hints.
GITHUB_TOKENPAT for GitHub API; optional if gh auth login provides a token.
HYPER_PM_AI_API_KEYEnables AI ticket body helpers.
HYPER_PM_ACTORDefault audit label for mutations (override with --actor).
TMPDIRDefault parent for disposable worktrees (override with --temp-dir).

Never commit real tokens. Use your shell profile, a secrets manager, or CI secret stores.

Global CLI options

These appear before the subcommand, for example hyper-pm --format text epic read. Full tables live on Global options.