Issue Import

Import GitHub issues and convert them into user stories ready for sprint planning.

Table of contents

1. Prerequisites
2. Import a Single Issue
3. Preview Without Updating the Issue
4. Import Multiple Issues
5. Seed File Output
6. Configuration

---

Prerequisites

• Install the GitHub CLI (gh) and authenticate (gh auth login).
• Configure YOLO_GITHUB__TOKEN or log in with gh.

---

Import a Single Issue

yolo import issue 42

This generates a story with acceptance criteria, then posts a summary comment back to the issue (unless --preview is used).

---

Preview Without Updating the Issue

yolo import preview 42

---

Import Multiple Issues

yolo import issues 12 34 56

Filter by label:

yolo import issues --label "ready" --auto-seed

Search query:

yolo import issues --query "is:open label:feature"

---

Seed File Output

Use --auto-seed to write a seed file for later use:

yolo import issue 42 --auto-seed

Seed files are stored in .yolo/imported-issues/.

---

Configuration

Customize import behavior in yolo.yaml:

github:
  import_config:
    enabled: true
    update_issues: true
    add_label: yolo-imported
    story:
      id_prefix: US
      estimate_points: true