Polymath Zero

Docs · Getting started

Import a GitHub issue as a case

Zero can import a GitHub issue directly into a case. The import creates a structured case with the issue title, body, acceptance criteria, and metadata pre-loaded into case memory.

Steps

  1. Open Zero. Launch the desktop app. Your workspace opens to the case list.
  2. Click Import from GitHub. Top-right of the case 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 case. Case opens in OPEN state. The issue is linked — progress comments roll up automatically.

What Zero writes

The import populates github-context.md in the case 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.