AI Issue Publisher

Stop losing good AI ideas in chat history.

Turn AI conversations into GitHub Issues with one command.

AI Issue Publisher converts AI-generated markdown from ChatGPT, Claude, Cursor, and other assistants into GitHub Issues.

The AI writes the idea. Humans decide whether it becomes work.

---

Installation

Homebrew (Recommended)

brew install replworks/tap/ai-issue

Go

go install github.com/replworks/ai-issue/cmd/ai-issue@latest

Verify installation:

ai-issue diagnose

---

Configuration

Authenticate with the GitHub App device flow:

ai-issue login

The command will:

• open the GitHub device login page
• show you an 8-digit code to enter
• save the resulting token locally after authorization

The token is stored at os.UserConfigDir()/ai-issue/token:

OS	Path
macOS	~/Library/Application Support/ai-issue/token
Linux	~/.config/ai-issue/token
Windows	%AppData%\ai-issue\token

Optional:

export AI_ISSUE_PUBLISHER=replworks-bot

The GitHub App must be installed on the repository or organization you want to publish to.

---

Usage

Copy AI-generated markdown to your clipboard and run:

ai-issue

Preview only:

ai-issue --dry-run

Diagnostics:

ai-issue diagnose

---

Example

AI Output

# Add timestamps to logging system

Current logs do not contain timestamps, making debugging difficult.

Acceptance Criteria

- Include UTC timestamps
- Preserve current log format
- Add tests

Publish

ai-issue

Result

✅ Issue created successfully!
https://github.com/owner/repository/issues/42

---

Core Philosophy

Author ≠ Publisher

AI Issue Publisher is built around a simple principle:

• AI authors the content.
• Humans review the content.
• Humans decide whether to publish it.

Publishing is always an explicit human decision.

Dedicated AI Identity

Issues are created under a dedicated AI identity.

By default:

@ai-backlog-bot

Override locally:

export AI_ISSUE_PUBLISHER=replworks-bot

This makes AI-generated issues immediately identifiable while preserving human accountability.

---

Troubleshooting

GitHub App token is required

ai-issue login

Repository could not be determined

Run the command inside a Git repository.

Clipboard is empty

Copy AI-generated markdown before running the command.

Resource not accessible by app token

Verify:

• The GitHub App is installed on the target repository or organization
• Issues: Read and write permission is granted
• You completed ai-issue login after installing the app
• Organization approval or SSO authorization is complete, if required

Need more details?

ai-issue diagnose

---

Development

Run tests:

go test ./...

Build:

make build

Release:

goreleaser release --clean

---

License

MIT

---

Built for developers who use AI every day and want good ideas to reach the backlog.