Skip to content

feat(cli): interactive splash menu and grouped help (#3) - #7

Merged
rosspeili merged 1 commit into
ARPAHLS:mainfrom
rosspeili:issue-3-cli-interactive
Aug 21, 2026
Merged

feat(cli): interactive splash menu and grouped help (#3)#7
rosspeili merged 1 commit into
ARPAHLS:mainfrom
rosspeili:issue-3-cli-interactive

Conversation

@rosspeili

Copy link
Copy Markdown
Contributor

Description

Adds an interactive CLI experience when aura is invoked with no subcommand: ASCII AURA splash, numbered menu (agents, sessions, run, home, help, version), and Skillware-style grouped help via aura --help. Existing subcommands (aura agent, aura run, aura export, etc.) are unchanged for scripting and CI.

Refactors the CLI into focused modules (commands, splash, interactive, help_ui, styles, help_text) and adds rich as a core dependency for tables and the gradient splash. Includes UTF-8-safe output handling for piped/legacy Windows terminals.

Closes #3 — extends the CLI integration tests from #2 with grouped help, interactive exit, and console script entry point checks.

Type

  • Bug fix
  • Core framework — session, spine, constraints, identity, audit report
  • CLI
  • Integration — sequencer, hosts, membrane, observers, exporters
  • Documentation
  • Examples
  • Packaging / CI

Checklist

  • Linked issue (Fixes #3)
  • pytest passes (53 passed)
  • black aura tests — no diff
  • flake8 aura tests — clean
  • CHANGELOG.md updated when user-visible behavior changes

Test plan

  • pytest tests/test_cli.py -v — version, agent CRUD, run, logs/export/compare/otel, grouped --help, interactive splash + 0 exit, console script entry point
  • pytest tests/ -q — full suite (53 passed)
  • Manual: bare aura shows splash and menu; aura --help shows grouped topics; aura agent list / aura version still scriptable
  • Verified wheel entry point: aura = "aura.cli.main:main" in pyproject.toml

Bare aura opens an ASCII splash and numbered menu; subcommands unchanged for scripting. Adds rich tables, CLI module split, and extended CLI tests.
@rosspeili
rosspeili merged commit cee57b1 into ARPAHLS:main Aug 21, 2026
1 check passed
@rosspeili
rosspeili deleted the issue-3-cli-interactive branch August 21, 2026 05:43
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.

[Enhancement]: CLI integration tests for aura commands

1 participant