drupal-issue-md

Convert Drupal.org issues to clean, LLM-friendly Markdown.

Stop struggling to feed Drupal.org issue context to ChatGPT, Claude, or other AI tools. This CLI fetches any issue via the Drupal.org REST API and outputs structured Markdown with metadata, issue summary, patches, and full comment history.

Install

npm install -g drupal-issue-md

CLI Usage

# Full issue with all comments
drupal-issue-md https://www.drupal.org/project/drupal/issues/2494073

# Just the issue ID works too
drupal-issue-md 2494073

# Summary only (metadata + description, no comments)
drupal-issue-md 2494073 --summary

# Save to file
drupal-issue-md 2494073 > issue.md

# Pipe to clipboard (macOS)
drupal-issue-md 2494073 --summary | pbcopy

Programmatic Usage

import { fetchIssue, formatIssue } from 'drupal-issue-md';

const issue = await fetchIssue('2494073', { summaryOnly: false });
const markdown = formatIssue(issue, { summaryOnly: false });
console.log(markdown);

Output Format

# [#2494073] Prevent modules with unmet Composer dependencies from being installed

## Metadata
| Field | Value |
|-------|-------|
| **Project** | drupal |
| **Status** | Needs work |
| **Priority** | Normal |
| ...   | ...   |

## Issue Summary
[Clean markdown conversion of the issue body]

## Related Issues
- [#2575469] Add composer/semver to core (Closed (fixed))

## Patches
| File | Size | URL |
|------|------|-----|
| patch-name-2494073-349.patch | 27.8 KB | https://... |

## Comments
### #1 — xano (2015-05-23)
[Comment body as markdown]

Options

| Flag | Description | |------|-------------| | --summary | Only output metadata and issue summary (skip comments and files) | | --help | Show usage information |

Rate Limiting

The tool respects Drupal.org's API rate limits with automatic retry and backoff. Large issues (100+ comments) may take 30-60 seconds to fetch.

License

MIT