Skip to content

Document CLI command aliases and interactive-mode auto-launch#356

Open
gronnerup wants to merge 4 commits into
mainfrom
cli/missing-command-shorthands
Open

Document CLI command aliases and interactive-mode auto-launch#356
gronnerup wants to merge 4 commits into
mainfrom
cli/missing-command-shorthands

Conversation

@gronnerup

Copy link
Copy Markdown
Collaborator

Summary

Fills two gaps in the CLI docs left over from the 0.6.0 milestone: command aliases were only documented for the three top-level renames, and the new launchInteractiveMode config key + TE_INTERACTIVE env var (running te in a terminal drops you into the REPL) were completely undocumented.

Command aliases

  • New Command aliases reference table on te-cli-commands.md listing every canonical/aliased pair (13 in total). Aliases shown as full aliased commands (te incremental-refresh rm, not bare rm) to remove any ambiguity about scope.
  • Inline (alias X) annotations on every subcommand overview table row where an alias exists (bpa rules, macro, config, session, profile, test, incremental-refresh).
  • First-line alias mention on H4 subcommand headings that have one.
  • One-time TIP callout on te-cli.md (overview) pointing new users to the full aliases table.

Interactive-mode auto-launch

Documenting the new default behavior where running te in a terminal with no arguments drops you into the REPL, plus the launchInteractiveMode config key (auto / always / never) and the TE_INTERACTIVE env var that control it.

  • te-cli-config.md - schema example, Behavioral defaults table, and env variables table.
  • te-cli-interactive.md - new "Auto-launch on empty invocation" section.
  • te-cli-commands.md - TIP under ### interactive.
  • te-cli.md - one-liner in the "Getting started" section.

Deliberate omission

te config show was removed in 0.6.0 (unlike the other renames, show is not kept as an alias). This is documented in the 0.6.0 announcement as a breaking change but not added as a "removed" note on the docs pages themselves, to avoid the docs accumulating a graveyard of removed-command notes.

Files changed

  • content/features/te-cli/te-cli.md
  • content/features/te-cli/te-cli-commands.md
  • content/features/te-cli/te-cli-config.md
  • content/features/te-cli/te-cli-interactive.md

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://delightful-mud-081affe03-356.westeurope.azurestaticapps.net

1 similar comment
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://delightful-mud-081affe03-356.westeurope.azurestaticapps.net

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://delightful-mud-081affe03-356.westeurope.azurestaticapps.net

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.

2 participants