Start a five-minute timer
Nothing later depends on completion. If shell setup takes longer, use the help fallback and continue.
Protect the rest of the course
Tab completion is useful, not required.
It can prevent dense parser errors caused by a mistyped command. It can also become a shell-specific detour. Stop at five minutes without apology.
Choose one of the five supported shells
armaraos completion --help
Use the value for the shell you are actually running. Do not guess from the operating system alone.
Recognize generated code
armaraos completion powershell
armaraos completion zsh
The command prints code to standard output. It does not install that code or edit a shell profile.
Load completion for this session
armaraos completion powershell | Out-String | Invoke-Expressionsource <(armaraos completion zsh)This affects the current shell only. Persistent installation depends on a shell profile and its security policy, not an ArmaraOS setting.
Keep the help fallback
armaraos --helparmaraos <group> --helparmaraos <group> <subcommand> --helpHelp works at three levels. Groups also accept a generated help subcommand, so armaraos agent help and armaraos agent --help expose the same inventory.
Check it / choose either success
Complete it, or skip it cleanly.
Type armaraos or and press Tab. If it completes to orchestration, completion works. If five minutes elapsed, run armaraos orchestration --help and continue.
Read generated code before adding it to a persistent profile. Do not weaken the shell execution policy merely for tab completion.
Troubleshooting for this sitting
| What you see | Likely cause | What to do |
|---|---|---|
| The script prints but Tab does nothing | It was printed, not loaded. | Use the current-session command for the correct shell. |
| PowerShell blocks loading | Execution policy or profile configuration. | Stop at five minutes and use help. |
| The syntax looks wrong | The wrong shell value was selected. | Check the shell and regenerate using a supported value. |