---
title: openplanr github
description: "openplanr github: Sync planning artifacts with GitHub Issues. Subcommands: push, sync, status."
url: https://openplanr.dev/docs/cli/github
updated: 2026-10-06
related:
  - https://openplanr.dev/docs/cli/context.md
  - https://openplanr.dev/docs/cli/voice.md
  - https://openplanr.dev/docs/cli/graph.md
---

# openplanr github

Sync planning artifacts with GitHub Issues

```text
openplanr github [options] [command]
```

## openplanr github push

Push artifacts to GitHub Issues

```text
openplanr github push [options] [artifactId]
```

Arguments:

- `artifactId` (optional): artifact ID to push (e.g., TASK-001)

Options:

- `--epic <epicId>`: push all artifacts under an epic
- `--all`: push all artifacts across all types

## openplanr github sync

Sync artifact status with GitHub Issues (bi-directional)

```text
openplanr github sync [options]
```

Options:

- `--direction <dir>`: sync direction: pull (GitHub→local), push (local→GitHub), or both; default `"both"`

## openplanr github status

Show sync status of all linked artifacts

```text
openplanr github status [options]
```