Skip to content

fix(cli): render help at a fixed width regardless of terminal size #312

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Jamie-BitFlight wants to merge 3 commits into
base: main
Choose a base branch
from
Open

fix(cli): render help at a fixed width regardless of terminal size #312

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
115ad56
fix(cli): render help at a fixed width regardless of terminal size
claude Sep 30, 2026
9459353
fix(cli): disable Typer pretty exceptions on the root app
claude Sep 30, 2026
e708fc2
docs(cli): source the 800-column help width
claude Sep 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion packages/skilllint/plugin_validator.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1822,7 +1822,18 @@ def _validate_with_cache(
# =============================================================================

# Create Typer app
app = typer.Typer(help="Validate Claude Code plugins and skills", add_completion=False)
app = typer.Typer(
help="Validate Claude Code plugins and skills",
add_completion=False,
# Help is read by agents, so it must not wrap or truncate to the caller's
# terminal. Click uses terminal_width as the exact help width (otherwise
# min(terminal columns, 80) - 2; typer/_click/formatting.py). 800 matches the
# Typer apps in claude_skills (daily-releases, receiving-pr-reviews,
# create-merge-request-changelog); lines longer than 800 columns still wrap.
context_settings={"terminal_width": 800},
Comment thread
Jamie-BitFlight marked this conversation as resolved.
rich_markup_mode=None,
pretty_exceptions_enable=False,
)
app.add_typer(docs_app, name="docs")

# Version option handled via callback
Expand Down
7 changes: 3 additions & 4 deletions packages/skilllint/tests/test_cli.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -836,15 +836,14 @@ def test_check_help_lists_every_registered_platform(self, cli_runner: CliRunner)
How: Render ``check --help`` and look for each ADAPTERS key in CLI form
Why: Agents are told to read accepted platform names from this help
"""
result = cli_runner.invoke(plugin_validator.app, ["check", "--help"])
# A narrow terminal must not wrap or truncate help: the app fixes terminal_width.
result = cli_runner.invoke(plugin_validator.app, ["check", "--help"], env={"COLUMNS": "40"})

assert result.exit_code == 0
assert plugin_validator.ADAPTERS
expected = ", ".join(sorted(plugin_validator.PLATFORM_CLI_IDS))
assert expected == plugin_validator.PLATFORM_CHOICES
assert "Platform adapter. Choices:" in result.output
for choice in expected.split(", "):
assert choice in result.output
assert f"Platform adapter. Choices: {expected}" in result.output

def test_hyphenated_third_party_platform_id_resolves_exactly(self, monkeypatch) -> None:
"""Registered adapter IDs containing hyphens remain directly selectable."""
Expand Down
Loading