Skip to content

feat(cli): DevX pass — version, grouped help, --agent-id, --json, convenience commands - #107

Open
abhishekmishragithub wants to merge 2 commits into
mainfrom
feat-cli-ux
Open

feat(cli): DevX pass — version, grouped help, --agent-id, --json, convenience commands#107
abhishekmishragithub wants to merge 2 commits into
mainfrom
feat-cli-ux

Conversation

@abhishekmishragithub

Copy link
Copy Markdown
Collaborator

Tiers 1 + 2 of the CLI UX redesign (CLI_UX_REDESIGN.md). All additive / non-breaking.

What's new

  • version + --version/-V — backed by smallestai.__version__.
  • Grouped welcome help (airbyte/gh style): BUILD & DEPLOY / VOICE AGENTS / TELEPHONY / SPEECH / SETUP, from a data-driven _GROUPS table.
  • Bug fix — wrong error string: agent-crew deploy/builds printed "Run 'smallestai agent init'", but the command is agent-crew init. Now correct and also names --agent-id.
  • --agent-id on agent-crew deploy/builds/logs (shared _resolve_agent_id), so crew commands work from CI or outside a project dir, not just where .smallestai/config.toml lives.
  • --json on agents list/get and agent-crew builds; builds skips the interactive picker under --json or a non-TTY (it would otherwise hang in CI).
  • Convenience commands: whoami, status (login/account/linked-agent/version, for bug reports), open (dashboard), docs, and a top-level doctor (env + connectivity diagnostics: key, API reach, PyPI version, npx).
  • Confirmation before "Take Down" (taking a live build offline).

Tests

New test_cli_ux.py (version, grouped help, docs/open URL fallback, --agent-id/--json presence). Full custom suite: 135 passed. ruff clean.

Out of scope here

  • Tier 3agent-crew cancel <build-id> is blocked on a platform cancel endpoint (separate atoms-platform PR in flight for cancel + stuck-build auto-timeout).
  • Tier 4 — breaking renames gated to 6.0 (with hidden aliases).

…venience commands

Tier 1+2 of the CLI UX redesign (CLI_UX_REDESIGN.md):
- version command + --version/-V (backed by smallestai.__version__).
- Grouped, airbyte/gh-style welcome help (BUILD & DEPLOY / VOICE AGENTS /
  TELEPHONY / SPEECH / SETUP) via a data-driven _GROUPS table.
- Fix misleading error strings: 'smallestai agent init' -> the real
  'smallestai agent-crew init', now also naming --agent-id (was a bug).
- --agent-id on agent-crew deploy/builds/logs via a shared _resolve_agent_id,
  so crew commands work from CI / outside a project dir.
- --json on agents list/get and agent-crew builds; builds skips the interactive
  picker in --json or non-TTY (it would hang in CI).
- New convenience commands: whoami, status, open, docs, top-level doctor
  (env/connectivity diagnostics).
- Confirmation prompt before Take Down (taking a live build offline).

All additive/non-breaking; the waves->models group already keeps a hidden alias.
Tier 3 (agent-crew cancel) is blocked on a platform cancel endpoint; Tier 4
(breaking) is gated to 6.0.
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