Skip to content

feat: branded welcome screen for bare CLI invocation#37

Merged
weklund merged 1 commit intomainfrom
feat/welcome-screen
Apr 4, 2026
Merged

feat: branded welcome screen for bare CLI invocation#37
weklund merged 1 commit intomainfrom
feat/welcome-screen

Conversation

@weklund
Copy link
Copy Markdown
Owner

@weklund weklund commented Apr 4, 2026

Summary

  • Replace plain --help dump with a branded welcome screen when running mlx-stack with no arguments
  • ASCII art banner (two-tone MLX/STACK, 78 cols wide), version, contextual chip/stack status, grouped commands, and a smart "get started" nudge
  • mlx-stack --help still shows the traditional reference help (usage, options, full command list)
  • Read-only status probes — never creates directories or writes files from the welcome screen

Test plan

  • All 1485 existing unit tests pass
  • test_bare_command_does_not_create_data_home still passes (critical constraint)
  • 4 new tests: banner rendering, version display, command categories, get-started nudge
  • ruff check clean
  • Verify CI passes

🤖 Generated with Claude Code

Replace plain help text with a branded welcome screen when running
`mlx-stack` with no arguments. Includes ASCII art banner, version,
contextual hardware/stack status, grouped commands, and a smart
"get started" nudge. `--help` still shows the traditional reference.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@weklund weklund merged commit b4becc9 into main Apr 4, 2026
5 checks passed
weklund added a commit that referenced this pull request Apr 4, 2026
🤖 I have created a release *beep* *boop*
---


## [0.3.7](v0.3.6...v0.3.7)
(2026-04-04)


### Features

* branded welcome screen for bare CLI invocation
([#37](#37))
([b4becc9](b4becc9))


### Security

* bump pygments from 2.19.2 to 2.20.0 — fixes catastrophic backtracking
in archetype, devicetree, and Lua lexers
([#36](#36))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Wes Eklund <s.wes35@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.

1 participant