feat(cli): status formatter + CLI gallery docs

[PatrickSys]

What / Why

Explain the change briefly.

Release notes

This repo uses an automated release flow.

• Please use a Conventional-Commits style PR title (we squash-merge): feat: ..., fix: ..., docs: ..., chore: ..., refactor: ...
• If this should not appear in release notes, say so here

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3368d5422e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Narrow the --json guarantee to commands that emit JSON

This new README contract says every CLI command produces machine JSON on stdout with --json, but the memory add/memory remove paths still always print plain text (Added.../Removed...) and never branch on --json (src/cli-memory.ts, add/remove branches). In automation, calling those subcommands with --json will return non-JSON output and break parsers, so the docs should either scope the promise to supported commands or the subcommands should implement JSON output.

Useful? React with 👍 / 👎.

[greptile-apps]

Greptile Summary

Added formatStatus function with terminal-adaptive output (Unicode/ASCII fallback via CODEBASE_CONTEXT_ASCII=1) and created comprehensive CLI gallery documentation in docs/cli.md.

Key changes:

• Implemented glyph abstraction system supporting both Unicode box-drawing and ASCII fallback characters
• Added formatStatus function to render index status in human-readable format
• All existing formatters (formatPatterns, formatSearch, formatRefs, formatCycles, formatMetadata, formatStyleGuide) updated to use glyph system
• New docs/cli.md provides CLI examples for onboarding and debugging
• README enhanced with CLI preview section showing formatted output examples
• Test coverage added for status command with environment variable handling

Confidence Score: 5/5

• This PR is safe to merge with no issues identified
• Clean implementation with proper abstractions, comprehensive test coverage, well-structured documentation, and adherence to project constraints (zero-infra, framework-agnostic, no any types). All formatters consistently use the new glyph system with proper fallbacks.
• No files require special attention

Important Files Changed

Filename	Overview
src/cli-formatters.ts	Added status formatter with ASCII/Unicode glyph system for terminal compatibility - clean implementation with proper fallbacks
src/cli.ts	Added environment variable documentation and connected status command to formatter - minimal, focused changes
tests/cli.test.ts	Added test coverage for status command with proper environment variable cleanup - well-structured test
docs/cli.md	New CLI gallery documentation with clear examples and ASCII fallback instructions - comprehensive and well-organized
docs/capabilities.md	Updated CLI reference and documented impact.details field with backward compatibility note
README.md	Added CLI gallery preview section and improved documentation structure - formatting improvements and clearer onboarding flow

_{Last reviewed commit: 3368d54}

[greptile-apps]

_{6 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}