Polymath Zero

Docs · Getting started

Import from GitHub

Zero can import a GitHub issue as a Work item. The import pre-loads the issue title, body, acceptance criteria, and metadata into the Work item's memory. The GitHub issue is source context — not the execution model.

Steps

  1. Open Zero. Launch the desktop app. Your workspace opens to your Work items.
  2. Click Import from GitHub. Top-right of the Work list. Requires your repository to be linked.
  3. Paste the issue URL or number. Zero fetches the issue metadata from GitHub.
  4. Review the imported context. Zero writes github-context.md with title, description, labels, acceptance criteria, and any linked PR references.
  5. Confirm and open the Work item. The Work item opens in OPEN state. The issue is linked — progress comments roll up automatically.

What Zero writes

The import populates github-context.md in the Work item's memory directory. Nothing is written to your repository — Zero never modifies the linked issue without an explicit operator action.

Notes

Repository access is configured during workspace setup. You do not paste GitHub access tokens during import.

Other import sources

Currently only GitHub Issues import is available. Other sources are on the roadmap.

  • Jira — planned. Import Jira tickets as Work items, including acceptance criteria as a proof checklist. Issue type maps to Zero Work type automatically.
  • Linear — planned. Import Linear issues and link back to the source record.
  • Manual — always available. Create a Work item directly in Zero without importing from an external tracker.