Skip to main content

Module flow

github_app_forge

Module flow 

Source
Expand description

Manifest-flow orchestrator.

GitHub doesn’t expose a pure REST API for creating apps — the only programmatic path is the Manifest flow, which requires exactly one browser confirmation. The flow:

  1. Tool starts a one-shot HTTP listener on an ephemeral localhost port.
  2. Tool generates an HTML page with a hidden-form POST to GitHub’s manifest endpoint (https://github.com/.../settings/apps/new), auto-submits via JS. Manifest body includes redirect_url=http://localhost:<port>/callback.
  3. Tool opens the operator’s default browser to that page (1 click on the “Create from manifest” confirmation in GitHub).
  4. GitHub redirects the browser to the localhost listener with ?code=<temp>.
  5. Listener captures the code, returns “you can close this tab”.
  6. Tool exchanges the code via POST /app-manifests/{code}/conversions.
  7. Tool optionally opens the install URL with target_id pre-filled (one more click) and polls GET /app/installations until the installation shows up.
  8. Tool writes credentials (id, slug, pem, installation_id) to the sink.

Functions§

run