Skip to content

chore(git-ape): switch progress bar from ASCII to Unicode blocks#126

Merged
arnaudlh merged 1 commit into
mainfrom
chore/git-ape-unicode-progress-bar
May 28, 2026
Merged

chore(git-ape): switch progress bar from ASCII to Unicode blocks#126
arnaudlh merged 1 commit into
mainfrom
chore/git-ape-unicode-progress-bar

Conversation

@arnaudlh
Copy link
Copy Markdown
Member

What

Replace the ASCII progress bar in the Git-Ape agent output style with Unicode block characters:

  • Filled cells: (U+2588 FULL BLOCK) instead of #
  • Empty cells: (U+2591 LIGHT SHADE) instead of -

Bar stays 10 cells wide (each cell = 10%).

Before:

[####------] 40%  Stage 2/4: Template Generation

After:

[████░░░░░░] 40%  Stage 2/4: Template Generation

Why

Unicode block bars render as a continuous shaded bar in both Markdown renderers and modern terminals, which reads more like a progress bar and less like a literal grid of characters. All Git-Ape output already uses Unicode glyphs elsewhere (, ), so this is consistent.

Files

  • .github/agents/git-ape.agent.md — source change
  • website/docs/agents/git-ape.md — regenerated mirror (auto-generated by scripts/generate-docs.js)

Use U+2588 (FULL BLOCK) for filled cells and U+2591 (LIGHT SHADE) for
empty cells in the shared progress bar pattern. Visually cleaner in
Markdown renderers and terminal output while keeping the same 10-cell
width (each cell = 10%).

Updates source agent and regenerated docs mirror.
@github-actions
Copy link
Copy Markdown
Contributor

⚠️ Documentation Staleness Warning

Source files (agents, skills, workflows, or config) changed in this PR, but the generated documentation is out of date.

Changed docs that need regeneration:

  • website/docs/reference/marketplace.md
  • website/docs/reference/plugin-json.md
  • website/docs/skills/overview.md
  • website/docs/skills/prereq-check.md
  • website/docs/workflows/daily-repo-status-lock.md
  • website/docs/workflows/git-ape-release.md
  • website/docs/workflows/issue-triage-agent-lock.md
  • website/docs/workflows/pr-validation.md
  • website/docs/workflows/waza-agent-evals.md
  • website/docs/workflows/waza-evals.md

To fix: Run the following command and commit the results:

node scripts/generate-docs.js

This is an advisory check — it does not block the PR.

@github-actions
Copy link
Copy Markdown
Contributor

🤖 Waza agent evals (advisory)

ℹ️ No agents evaluated. changed agent(s) have no eval directory: git-ape

Ran 0 agent evals against claude-sonnet-4.6. Each eval consumes ~5 premium Copilot requests; results are non-blocking — investigate failures via the workflow logs and the per-agent waza-agent-results-* artifacts.

How this works: This workflow auto-syncs the canonical .github/agents/<name>.agent.md into the sibling mirror inside .github/evals/agents/<name>/ before each run, so the score below reflects the version of the agent in this PR — not whatever was committed when the eval was first wired up.

📊 Agent file token comparison vs main (advisory)

No .agent.md files changed vs main (or token-compare returned no entries).

No agents in scope for this PR.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Git-Ape agent’s documented output styling guidelines to use Unicode block characters for progress bars (filled , empty ) instead of ASCII (#/-), aligning with other Unicode glyphs already used in Git-Ape output.

Changes:

  • Switched the documented progress bar pattern from ASCII to Unicode blocks in the Git-Ape agent prompt.
  • Updated the sample deployment output examples to match the new Unicode bar style.
  • Regenerated the website mirror documentation to reflect the source agent prompt.
Show a summary per file
File Description
.github/agents/git-ape.agent.md Updates the canonical agent prompt to specify Unicode block progress bars and adjusts examples accordingly.
website/docs/agents/git-ape.md Updates the auto-generated documentation mirror to match the agent prompt changes.

Copilot's findings

  • Files reviewed: 2/2 changed files
  • Comments generated: 0

@sendtoshailesh
Copy link
Copy Markdown
Contributor

Review summary

This PR replaces ASCII characters (#, -) with Unicode block characters (, ) in the Git-Ape agent's progress bar examples. The change affects the source agent file and its auto-generated docs mirror, making progress bars render as visually continuous shaded bars.

Correctness

Character substitution is accurate: Verified all 5 progress bar examples use (U+2588 FULL BLOCK) for filled cells and (U+2591 LIGHT SHADE) for empty cells as claimed.

Math checks out: All progress bars remain exactly 10 cells wide with correct percentages:

  • 20% = 2 filled + 8 empty
  • 40% = 4 filled + 6 empty
  • 60% = 6 filled + 4 empty
  • 100% = 10 filled + 0 empty

Complete coverage: Both changed files (.github/agents/git-ape.agent.md and website/docs/agents/git-ape.md) contain zero old ASCII patterns in the PR head ref.

Documentation updated: The "Progress Bar Pattern" section header changed from "(ASCII-only)" to "(Unicode blocks)" and includes the new character reference with Unicode codepoints.

No stale references: The azure-resource-deployer.agent.md inherits this style via reference to git-ape.agent.md, so no update needed there.

CI passing: All checks green, including Markdown lint, structural validation, and CodeQL.

LGTM — the change is exactly as described, mathematically correct, and complete.

@arnaudlh arnaudlh merged commit 058b4ed into main May 28, 2026
12 checks passed
@arnaudlh arnaudlh deleted the chore/git-ape-unicode-progress-bar branch May 28, 2026 00:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants