Mission ships as the @flying-pillow/open-mission CLI package.

npx @flying-pillow/open-mission

For repeated use:

npm install -g @flying-pillow/open-mission
open-mission

Requirements

  • Node 24
  • pnpm for local development in this repository
  • Git
  • Optional GitHub App credentials if this Open Mission installation will perform unattended GitHub operations

open-mission install configures local filesystem roots and other non-secret Open Mission settings. GitHub App secrets are not written into Open Mission config; provide them through environment variables before you start Open Mission.

If you are self-hosting Open Mission for an organization and want unattended GitHub operations, continue with Self-Hosted GitHub App Setup.

That self-hosted flow now includes binding each Repository to its installed GitHub App authorization after browser sign-in.

What Starts

The CLI opens Open Mission and connects it to the Open Mission daemon. The daemon owns repository state, Mission runtime state, Entity command dispatch, and agent adapter coordination.

After Open Mission opens, continue with Repository Setup.