omni-ai-cli 1.2.0 → 1.4.0

package/README.md

@@ -7,6 +7,7 @@
 [![npm](https://img.shields.io/npm/v/omni-ai-cli?color=C4552F)](https://www.npmjs.com/package/omni-ai-cli)
 [![downloads](https://img.shields.io/npm/dm/omni-ai-cli?color=1A1714)](https://www.npmjs.com/package/omni-ai-cli)
 [![provenance](https://img.shields.io/badge/npm-OIDC%20trusted%20publishing-C4552F)](https://docs.npmjs.com/trusted-publishers)
+[![coverage](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/samuelrms/omni-ai-cli/badges/coverage.json)](https://github.com/samuelrms/omni-ai-cli/actions/workflows/coverage.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-C4552F.svg)](LICENSE)
 ![Plataformas](https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows-1A1714)
 ![Idiomas](https://img.shields.io/badge/pt--BR%20·%20en%20·%20es%20·%20fr-C4552F)
@@ -111,6 +112,14 @@ bun add -g omni-ai-cli
 
 Qualquer um dos comandos acima (script ou gerenciador de pacotes) instala o mesmo `ai`.
 
+**Homebrew** (macOS/Linux):
+
+```bash
+brew install samuelrms/tap/omni-ai-cli
+```
+
+> Em Homebrew recente, se recusar o tap como "untrusted", rode uma vez: `brew trust samuelrms/tap`.
+
 Para atualizar depois: `ai --update` (ou `/update` no chat).
 
 Pelo código-fonte, para desenvolver:
@@ -388,6 +397,8 @@ ai --install                           # instala as ferramentas que faltam (perg
 ai --classify "prompt"                 # mostra como seria classificado
 ai --log                               # últimas chamadas
 ai doctor                              # diagnóstico de instalação, contas e chaves
+ai --version                           # versão do Omni AI CLI
+ai --completions zsh|bash              # autocomplete do shell
 ```
 
 ---
@@ -449,7 +460,7 @@ python3 -m unittest discover -s tests -v
 bash -n scripts/install.sh
 ```
 
-**106 testes**: persistência e retomada de sessão, limite de contexto, permissão dos
+**123 testes**: persistência e retomada de sessão, limite de contexto, permissão dos
 arquivos, sessão aberta em dois terminais, leitura de eventos, cancelamento da árvore de
 processos, paralelismo real, sandbox somente leitura, mascaramento de dados pessoais,
 fallback OpenRouter → Codex, validação de modelos, armazenamento das chaves e o ciclo de vida das contas. Todos os

package/docs/README.en.md

@@ -7,6 +7,7 @@
 [![npm](https://img.shields.io/npm/v/omni-ai-cli?color=C4552F)](https://www.npmjs.com/package/omni-ai-cli)
 [![downloads](https://img.shields.io/npm/dm/omni-ai-cli?color=1A1714)](https://www.npmjs.com/package/omni-ai-cli)
 [![provenance](https://img.shields.io/badge/npm-OIDC%20trusted%20publishing-C4552F)](https://docs.npmjs.com/trusted-publishers)
+[![coverage](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/samuelrms/omni-ai-cli/badges/coverage.json)](https://github.com/samuelrms/omni-ai-cli/actions/workflows/coverage.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-C4552F.svg)](../LICENSE)
 ![Platforms](https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows-1A1714)
 ![Languages](https://img.shields.io/badge/pt--BR%20·%20en%20·%20es%20·%20fr-C4552F)
@@ -111,6 +112,14 @@ bun add -g omni-ai-cli
 
 Any of the commands above (script or package manager) installs the same `ai`.
 
+**Homebrew** (macOS/Linux):
+
+```bash
+brew install samuelrms/tap/omni-ai-cli
+```
+
+> On recent Homebrew, if it refuses the tap as "untrusted", run once: `brew trust samuelrms/tap`.
+
 To update later: `ai --update` (or `/update` in the chat).
 
 From source, for development:
@@ -387,6 +396,8 @@ ai --install                           # installs the missing tools (asks first)
 ai --classify "prompt"                 # shows how it would be classified
 ai --log                               # latest calls
 ai doctor                              # diagnose install, accounts and keys
+ai --version                           # Omni AI CLI version
+ai --completions zsh|bash              # shell autocomplete
 ```
 
 ---
@@ -448,7 +459,7 @@ python3 -m unittest discover -s tests -v
 bash -n scripts/install.sh
 ```
 
-**106 tests**: session persistence and resume, context limit, file permissions, session
+**123 tests**: session persistence and resume, context limit, file permissions, session
 open in two terminals, event reading, process tree cancellation, real parallelism,
 read-only sandbox, personal data masking, OpenRouter → Codex fallback, model
 validation, key storage and the account lifecycle. All the

package/docs/README.es.md

@@ -7,6 +7,7 @@
 [![npm](https://img.shields.io/npm/v/omni-ai-cli?color=C4552F)](https://www.npmjs.com/package/omni-ai-cli)
 [![downloads](https://img.shields.io/npm/dm/omni-ai-cli?color=1A1714)](https://www.npmjs.com/package/omni-ai-cli)
 [![provenance](https://img.shields.io/badge/npm-OIDC%20trusted%20publishing-C4552F)](https://docs.npmjs.com/trusted-publishers)
+[![coverage](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/samuelrms/omni-ai-cli/badges/coverage.json)](https://github.com/samuelrms/omni-ai-cli/actions/workflows/coverage.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-C4552F.svg)](../LICENSE)
 ![Plataformas](https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows-1A1714)
 ![Idiomas](https://img.shields.io/badge/pt--BR%20·%20en%20·%20es%20·%20fr-C4552F)
@@ -112,6 +113,14 @@ bun add -g omni-ai-cli
 
 Cualquiera de los comandos de arriba (script o gestor de paquetes) instala el mismo `ai`.
 
+**Homebrew** (macOS/Linux):
+
+```bash
+brew install samuelrms/tap/omni-ai-cli
+```
+
+> En Homebrew reciente, si rechaza el tap como "untrusted", ejecuta una vez: `brew trust samuelrms/tap`.
+
 Para actualizar después: `ai --update` (o `/update` en el chat).
 
 Desde el código fuente, para desarrollar:
@@ -388,6 +397,8 @@ ai --install                           # instala las herramientas que faltan (pr
 ai --classify "prompt"                 # muestra cómo se clasificaría
 ai --log                               # últimas llamadas
 ai doctor                              # diagnóstico de instalación, cuentas y claves
+ai --version                           # versión de Omni AI CLI
+ai --completions zsh|bash              # autocompletado del shell
 ```
 
 ---
@@ -449,7 +460,7 @@ python3 -m unittest discover -s tests -v
 bash -n scripts/install.sh
 ```
 
-**106 pruebas**: persistencia y reanudación de sesión, límite de contexto, permisos de
+**123 pruebas**: persistencia y reanudación de sesión, límite de contexto, permisos de
 los archivos, sesión abierta en dos terminales, lectura de eventos, cancelación del árbol
 de procesos, paralelismo real, sandbox de solo lectura, enmascaramiento de datos
 personales, fallback OpenRouter → Codex, validación de modelos, almacenamiento de las

package/docs/README.fr.md

@@ -7,6 +7,7 @@
 [![npm](https://img.shields.io/npm/v/omni-ai-cli?color=C4552F)](https://www.npmjs.com/package/omni-ai-cli)
 [![downloads](https://img.shields.io/npm/dm/omni-ai-cli?color=1A1714)](https://www.npmjs.com/package/omni-ai-cli)
 [![provenance](https://img.shields.io/badge/npm-OIDC%20trusted%20publishing-C4552F)](https://docs.npmjs.com/trusted-publishers)
+[![coverage](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/samuelrms/omni-ai-cli/badges/coverage.json)](https://github.com/samuelrms/omni-ai-cli/actions/workflows/coverage.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-C4552F.svg)](../LICENSE)
 ![Plateformes](https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows-1A1714)
 ![Langues](https://img.shields.io/badge/pt--BR%20·%20en%20·%20es%20·%20fr-C4552F)
@@ -114,6 +115,14 @@ bun add -g omni-ai-cli
 
 N'importe laquelle des commandes ci-dessus (script ou gestionnaire de paquets) installe le même `ai`.
 
+**Homebrew** (macOS/Linux) :
+
+```bash
+brew install samuelrms/tap/omni-ai-cli
+```
+
+> Sur Homebrew récent, s'il refuse le tap comme « untrusted », exécutez une fois : `brew trust samuelrms/tap`.
+
 Pour mettre à jour ensuite : `ai --update` (ou `/update` dans le chat).
 
 Depuis les sources, pour développer :
@@ -397,6 +406,8 @@ ai --install                           # installe les outils manquants (demande
 ai --classify "prompt"                 # montre la classification
 ai --log                               # derniers appels
 ai doctor                              # diagnostic installation, comptes et clés
+ai --version                           # version d'Omni AI CLI
+ai --completions zsh|bash              # autocomplétion du shell
 ```
 
 ---
@@ -458,7 +469,7 @@ python3 -m unittest discover -s tests -v
 bash -n scripts/install.sh
 ```
 
-**106 tests** : persistance et reprise de session, limite de contexte, permissions des
+**123 tests** : persistance et reprise de session, limite de contexte, permissions des
 fichiers, session ouverte dans deux terminaux, lecture des événements, annulation de
 l'arbre de processus, parallélisme réel, sandbox en lecture seule, masquage des données
 personnelles, fallback OpenRouter → Codex, validation des modèles, stockage des clés et

package/omni_ai/cli.py

@@ -690,6 +690,37 @@ def ai_version():
         return '?'
 
 
+def completion_words():
+    """Every top-level word `ai` accepts, for shell completion."""
+    flags = ['--model', '--account', '--key', '--keys', '--sync', '--usage', '--limits', '--setup',
+             '--install', '--status', '--doctor', '--reset', '--log', '--classify', '--update',
+             '--mode', '--chat', '--resume', '--sessions', '--new', '--help', '--version', '--completions']
+    return flags + ['--' + name for name in TOOLS] + ['doctor']
+
+
+def completions(shell):
+    """A completion script for `ai`, printed for the user to source. Completes the top-level flags."""
+    words = ' '.join(completion_words())
+    if shell == 'bash':
+        say(f'''# Omni AI CLI bash completion. Install:  ai --completions bash > ~/.ai-completion.bash
+#   then add to ~/.bashrc:  source ~/.ai-completion.bash
+_ai_complete() {{
+  local cur="${{COMP_WORDS[COMP_CWORD]}}"
+  COMPREPLY=( $(compgen -W "{words}" -- "$cur") )
+}}
+complete -F _ai_complete ai''')
+        return 0
+    if shell == 'zsh':
+        say(f'''#compdef ai
+# Omni AI CLI zsh completion. Install:  ai --completions zsh > ~/.zsh/_ai
+#   then ensure that dir is on $fpath before compinit in ~/.zshrc
+_ai() {{ compadd -- {words} }}
+compdef _ai ai''')
+        return 0
+    say(f'{RED}✗ Shell não suportado: {shell}. Use zsh ou bash.{NC}')
+    return 1
+
+
 def doctor():
     """Health check: what is installed, logged in and configured, and what is missing. Returns 1 when
     nothing can answer a request (no Claude login and no API key), 0 otherwise."""
@@ -987,6 +1018,8 @@ USAGE = f'''{BOLD}Uso:{NC}
   ai --install                       Instala as ferramentas que faltam (pergunta antes)
   ai --status | --doctor | --reset | --log | --classify "prompt"
   ai --update                        Atualizar para a versão mais nova
+  ai --version                       Versão do Omni AI CLI
+  ai --completions zsh|bash          Script de autocomplete do shell
 '''
 
 
@@ -1037,6 +1070,11 @@ def main(argv):
             return 0
         elif arg in ('--doctor', 'doctor'):
             return doctor()
+        elif arg in ('--version', '-v'):
+            say(ai_version())
+            return 0
+        elif arg == '--completions':
+            return completions(argv[i + 1] if i + 1 < len(argv) else '')
         elif arg in ('--setup', '--install'):
             from . import onboarding
             onboarding.main(install_missing=arg == '--install' or 'install' in argv[i + 1:])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-ai-cli",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "One chat for Claude Code, Codex, Antigravity and OpenRouter, with automatic routing, account fallback, API keys, permission modes and MCP/skill sync.",
   "bin": {
     "ai": "bin/ai.js",