raggedy

Fix ragged right edges in LLM-generated ASCII/Unicode box diagrams.

LLMs consistently generate ASCII box diagrams with inconsistent right borders — missing corners, short rules, content lines without closing borders. raggedy autodetects these diagrams inside markdown fenced code blocks and fixes them.

Install & Run

# Run directly with uvx (no install needed)
uvx raggedy file.md

# Or install with pip/uv
pip install raggedy
raggedy file.md

Usage

raggedy [OPTIONS] FILE [FILE...]

Options:
  -b, --backup      Create .bak backup before editing
  --check           Exit 1 if changes needed (no modification; for CI)
  --diff            Show diff without modifying
  -h, --help        Show help

What It Fixes

Given a markdown file containing:

```
┌──────────────────┐
│ Header           │
├──────────────────┤
│ Row 1
│ Row 2 is longer content
│ Short
└──────────────────┘
```

Running raggedy file.md produces:

```
┌────────────────────────┐
│ Header                 │
├────────────────────────┤
│ Row 1                  │
│ Row 2 is longer content│
│ Short                  │
└────────────────────────┘
```

Supports both Unicode (┌│├└) and ASCII (+|-) box-drawing styles.

CI Usage

Use --check in CI to enforce clean diagrams:

raggedy --check docs/**/*.md

Local Development

When running raggedy from the working tree via uvx, use --no-cache so the latest local code is rebuilt and executed:

uvx --from . --no-cache raggedy -b mantissa.md

AGENTS/Skills Usage

If you drive raggedy via an AGENTS.md entry or a skills file, use uvx to run the local working tree explicitly. Example prompt:

Issue `uvx raggedy <file>` to fix ragged diagram edges in markdown.

See the full example in skills.md.