Skip to content

feat: First-run support notice and quiet flag#29

Merged
tommed merged 1 commit intomainfrom
feat/first-run-notice
Apr 14, 2026
Merged

feat: First-run support notice and quiet flag#29
tommed merged 1 commit intomainfrom
feat/first-run-notice

Conversation

@tommed
Copy link
Copy Markdown
Contributor

@tommed tommed commented Apr 14, 2026

Summary

Adds a first-run support notice that displays once when users run any nexa CLI command, with links to support tiers and community resources. The notice can be suppressed via --quiet flag or NEXA_QUIET environment variable.

Changes

  • New notice.py module with platform-aware config directory handling (Windows AppData/roaming, Unix XDG_CONFIG_HOME)
  • Add --quiet / -q flag to nexa run and nexa compare commands
  • Support notice displayed on stderr on first invocation, marker file prevents re-display
  • Environment variable override: NEXA_QUIET=1 nexa run ...
  • Updated documentation and examples
  • Tests for notice display logic and edge cases

Test plan

  • Run nexa run examples/ml_da_algo.py and verify support notice appears on first run
  • Run again and verify notice does not appear (marker file in place)
  • Run with --quiet flag and verify notice is suppressed
  • Run with NEXA_QUIET=1 and verify notice is suppressed
  • Test on Windows, macOS, and Linux (config directory paths differ per platform)
  • Verify marker file created in correct location per platform
  • Run test suite: make ci

🤖 Generated with Claude Code

Add a first-run support notice that displays a single time with links to
support tiers and community resources. The notice is shown on stderr and
controlled via --quiet flag or NEXA_QUIET environment variable.

- Add notice.py module with platform-aware config directory handling
- Add --quiet flag to nexa run and nexa compare commands
- Update documentation and examples
- Add tests for notice display logic

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@tommed tommed self-assigned this Apr 14, 2026
@tommed tommed added documentation Improvements or additions to documentation enhancement New feature or request labels Apr 14, 2026
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 14, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@tommed tommed merged commit ca84316 into main Apr 14, 2026
2 checks passed
@tommed tommed deleted the feat/first-run-notice branch April 14, 2026 15:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant