omni-ai-cli 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (177) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +615 -2
  3. package/bin/ai.js +84 -0
  4. package/docs/README.en.md +615 -0
  5. package/docs/README.es.md +618 -0
  6. package/docs/README.fr.md +630 -0
  7. package/omni_ai/__init__.py +1 -0
  8. package/omni_ai/__main__.py +6 -0
  9. package/omni_ai/chat.py +1458 -0
  10. package/omni_ai/cli.py +991 -0
  11. package/omni_ai/config.py +531 -0
  12. package/omni_ai/deepseek.py +57 -0
  13. package/omni_ai/grok.py +111 -0
  14. package/omni_ai/onboarding.py +196 -0
  15. package/omni_ai/openrouter.py +335 -0
  16. package/omni_ai/osutils.py +86 -0
  17. package/omni_ai/pii.py +281 -0
  18. package/omni_ai/profiles.json +69 -0
  19. package/omni_ai/skills.py +124 -0
  20. package/omni_ai/sync.py +199 -0
  21. package/omni_ai/tools.py +75 -0
  22. package/omni_ai/ui.py +595 -0
  23. package/omni_ai/usage.py +305 -0
  24. package/omni_ai/vendor/prompt_toolkit/LICENSE +27 -0
  25. package/omni_ai/vendor/prompt_toolkit/__init__.py +52 -0
  26. package/omni_ai/vendor/prompt_toolkit/application/__init__.py +32 -0
  27. package/omni_ai/vendor/prompt_toolkit/application/application.py +1626 -0
  28. package/omni_ai/vendor/prompt_toolkit/application/current.py +195 -0
  29. package/omni_ai/vendor/prompt_toolkit/application/dummy.py +55 -0
  30. package/omni_ai/vendor/prompt_toolkit/application/run_in_terminal.py +114 -0
  31. package/omni_ai/vendor/prompt_toolkit/auto_suggest.py +177 -0
  32. package/omni_ai/vendor/prompt_toolkit/buffer.py +2029 -0
  33. package/omni_ai/vendor/prompt_toolkit/cache.py +127 -0
  34. package/omni_ai/vendor/prompt_toolkit/clipboard/__init__.py +17 -0
  35. package/omni_ai/vendor/prompt_toolkit/clipboard/base.py +109 -0
  36. package/omni_ai/vendor/prompt_toolkit/clipboard/in_memory.py +44 -0
  37. package/omni_ai/vendor/prompt_toolkit/clipboard/pyperclip.py +42 -0
  38. package/omni_ai/vendor/prompt_toolkit/completion/__init__.py +43 -0
  39. package/omni_ai/vendor/prompt_toolkit/completion/base.py +438 -0
  40. package/omni_ai/vendor/prompt_toolkit/completion/deduplicate.py +45 -0
  41. package/omni_ai/vendor/prompt_toolkit/completion/filesystem.py +118 -0
  42. package/omni_ai/vendor/prompt_toolkit/completion/fuzzy_completer.py +213 -0
  43. package/omni_ai/vendor/prompt_toolkit/completion/nested.py +109 -0
  44. package/omni_ai/vendor/prompt_toolkit/completion/word_completer.py +94 -0
  45. package/omni_ai/vendor/prompt_toolkit/contrib/__init__.py +0 -0
  46. package/omni_ai/vendor/prompt_toolkit/contrib/completers/__init__.py +5 -0
  47. package/omni_ai/vendor/prompt_toolkit/contrib/completers/system.py +64 -0
  48. package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/__init__.py +80 -0
  49. package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/compiler.py +579 -0
  50. package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/completion.py +100 -0
  51. package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/lexer.py +94 -0
  52. package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/regex_parser.py +279 -0
  53. package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/validation.py +60 -0
  54. package/omni_ai/vendor/prompt_toolkit/contrib/ssh/__init__.py +8 -0
  55. package/omni_ai/vendor/prompt_toolkit/contrib/ssh/server.py +178 -0
  56. package/omni_ai/vendor/prompt_toolkit/contrib/telnet/__init__.py +7 -0
  57. package/omni_ai/vendor/prompt_toolkit/contrib/telnet/log.py +13 -0
  58. package/omni_ai/vendor/prompt_toolkit/contrib/telnet/protocol.py +209 -0
  59. package/omni_ai/vendor/prompt_toolkit/contrib/telnet/server.py +428 -0
  60. package/omni_ai/vendor/prompt_toolkit/cursor_shapes.py +117 -0
  61. package/omni_ai/vendor/prompt_toolkit/data_structures.py +18 -0
  62. package/omni_ai/vendor/prompt_toolkit/document.py +1182 -0
  63. package/omni_ai/vendor/prompt_toolkit/enums.py +19 -0
  64. package/omni_ai/vendor/prompt_toolkit/eventloop/__init__.py +31 -0
  65. package/omni_ai/vendor/prompt_toolkit/eventloop/async_generator.py +125 -0
  66. package/omni_ai/vendor/prompt_toolkit/eventloop/inputhook.py +191 -0
  67. package/omni_ai/vendor/prompt_toolkit/eventloop/utils.py +101 -0
  68. package/omni_ai/vendor/prompt_toolkit/eventloop/win32.py +72 -0
  69. package/omni_ai/vendor/prompt_toolkit/filters/__init__.py +71 -0
  70. package/omni_ai/vendor/prompt_toolkit/filters/app.py +419 -0
  71. package/omni_ai/vendor/prompt_toolkit/filters/base.py +261 -0
  72. package/omni_ai/vendor/prompt_toolkit/filters/cli.py +65 -0
  73. package/omni_ai/vendor/prompt_toolkit/filters/utils.py +41 -0
  74. package/omni_ai/vendor/prompt_toolkit/formatted_text/__init__.py +59 -0
  75. package/omni_ai/vendor/prompt_toolkit/formatted_text/ansi.py +297 -0
  76. package/omni_ai/vendor/prompt_toolkit/formatted_text/base.py +179 -0
  77. package/omni_ai/vendor/prompt_toolkit/formatted_text/html.py +145 -0
  78. package/omni_ai/vendor/prompt_toolkit/formatted_text/pygments.py +32 -0
  79. package/omni_ai/vendor/prompt_toolkit/formatted_text/utils.py +103 -0
  80. package/omni_ai/vendor/prompt_toolkit/history.py +306 -0
  81. package/omni_ai/vendor/prompt_toolkit/input/__init__.py +14 -0
  82. package/omni_ai/vendor/prompt_toolkit/input/ansi_escape_sequences.py +344 -0
  83. package/omni_ai/vendor/prompt_toolkit/input/base.py +153 -0
  84. package/omni_ai/vendor/prompt_toolkit/input/defaults.py +79 -0
  85. package/omni_ai/vendor/prompt_toolkit/input/posix_pipe.py +118 -0
  86. package/omni_ai/vendor/prompt_toolkit/input/posix_utils.py +97 -0
  87. package/omni_ai/vendor/prompt_toolkit/input/typeahead.py +78 -0
  88. package/omni_ai/vendor/prompt_toolkit/input/vt100.py +309 -0
  89. package/omni_ai/vendor/prompt_toolkit/input/vt100_parser.py +250 -0
  90. package/omni_ai/vendor/prompt_toolkit/input/win32.py +749 -0
  91. package/omni_ai/vendor/prompt_toolkit/input/win32_pipe.py +156 -0
  92. package/omni_ai/vendor/prompt_toolkit/key_binding/__init__.py +22 -0
  93. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/__init__.py +0 -0
  94. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/auto_suggest.py +66 -0
  95. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/basic.py +257 -0
  96. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/completion.py +206 -0
  97. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/cpr.py +30 -0
  98. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/emacs.py +563 -0
  99. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/focus.py +26 -0
  100. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/mouse.py +348 -0
  101. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/named_commands.py +691 -0
  102. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/open_in_editor.py +52 -0
  103. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/page_navigation.py +85 -0
  104. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/scroll.py +190 -0
  105. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/search.py +96 -0
  106. package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/vi.py +2233 -0
  107. package/omni_ai/vendor/prompt_toolkit/key_binding/defaults.py +63 -0
  108. package/omni_ai/vendor/prompt_toolkit/key_binding/digraphs.py +1378 -0
  109. package/omni_ai/vendor/prompt_toolkit/key_binding/emacs_state.py +36 -0
  110. package/omni_ai/vendor/prompt_toolkit/key_binding/key_bindings.py +670 -0
  111. package/omni_ai/vendor/prompt_toolkit/key_binding/key_processor.py +526 -0
  112. package/omni_ai/vendor/prompt_toolkit/key_binding/vi_state.py +107 -0
  113. package/omni_ai/vendor/prompt_toolkit/keys.py +222 -0
  114. package/omni_ai/vendor/prompt_toolkit/layout/__init__.py +147 -0
  115. package/omni_ai/vendor/prompt_toolkit/layout/containers.py +2738 -0
  116. package/omni_ai/vendor/prompt_toolkit/layout/controls.py +945 -0
  117. package/omni_ai/vendor/prompt_toolkit/layout/dimension.py +220 -0
  118. package/omni_ai/vendor/prompt_toolkit/layout/dummy.py +40 -0
  119. package/omni_ai/vendor/prompt_toolkit/layout/layout.py +412 -0
  120. package/omni_ai/vendor/prompt_toolkit/layout/margins.py +304 -0
  121. package/omni_ai/vendor/prompt_toolkit/layout/menus.py +748 -0
  122. package/omni_ai/vendor/prompt_toolkit/layout/mouse_handlers.py +56 -0
  123. package/omni_ai/vendor/prompt_toolkit/layout/processors.py +1010 -0
  124. package/omni_ai/vendor/prompt_toolkit/layout/screen.py +323 -0
  125. package/omni_ai/vendor/prompt_toolkit/layout/scrollable_pane.py +494 -0
  126. package/omni_ai/vendor/prompt_toolkit/layout/utils.py +80 -0
  127. package/omni_ai/vendor/prompt_toolkit/lexers/__init__.py +21 -0
  128. package/omni_ai/vendor/prompt_toolkit/lexers/base.py +85 -0
  129. package/omni_ai/vendor/prompt_toolkit/lexers/pygments.py +328 -0
  130. package/omni_ai/vendor/prompt_toolkit/log.py +13 -0
  131. package/omni_ai/vendor/prompt_toolkit/mouse_events.py +85 -0
  132. package/omni_ai/vendor/prompt_toolkit/output/__init__.py +15 -0
  133. package/omni_ai/vendor/prompt_toolkit/output/base.py +332 -0
  134. package/omni_ai/vendor/prompt_toolkit/output/color_depth.py +64 -0
  135. package/omni_ai/vendor/prompt_toolkit/output/conemu.py +65 -0
  136. package/omni_ai/vendor/prompt_toolkit/output/defaults.py +106 -0
  137. package/omni_ai/vendor/prompt_toolkit/output/flush_stdout.py +87 -0
  138. package/omni_ai/vendor/prompt_toolkit/output/plain_text.py +143 -0
  139. package/omni_ai/vendor/prompt_toolkit/output/vt100.py +748 -0
  140. package/omni_ai/vendor/prompt_toolkit/output/win32.py +683 -0
  141. package/omni_ai/vendor/prompt_toolkit/output/windows10.py +128 -0
  142. package/omni_ai/vendor/prompt_toolkit/patch_stdout.py +297 -0
  143. package/omni_ai/vendor/prompt_toolkit/py.typed +0 -0
  144. package/omni_ai/vendor/prompt_toolkit/renderer.py +814 -0
  145. package/omni_ai/vendor/prompt_toolkit/search.py +226 -0
  146. package/omni_ai/vendor/prompt_toolkit/selection.py +58 -0
  147. package/omni_ai/vendor/prompt_toolkit/shortcuts/__init__.py +46 -0
  148. package/omni_ai/vendor/prompt_toolkit/shortcuts/dialogs.py +330 -0
  149. package/omni_ai/vendor/prompt_toolkit/shortcuts/progress_bar/__init__.py +33 -0
  150. package/omni_ai/vendor/prompt_toolkit/shortcuts/progress_bar/base.py +449 -0
  151. package/omni_ai/vendor/prompt_toolkit/shortcuts/progress_bar/formatters.py +431 -0
  152. package/omni_ai/vendor/prompt_toolkit/shortcuts/prompt.py +1513 -0
  153. package/omni_ai/vendor/prompt_toolkit/shortcuts/utils.py +239 -0
  154. package/omni_ai/vendor/prompt_toolkit/styles/__init__.py +67 -0
  155. package/omni_ai/vendor/prompt_toolkit/styles/base.py +184 -0
  156. package/omni_ai/vendor/prompt_toolkit/styles/defaults.py +236 -0
  157. package/omni_ai/vendor/prompt_toolkit/styles/named_colors.py +162 -0
  158. package/omni_ai/vendor/prompt_toolkit/styles/pygments.py +70 -0
  159. package/omni_ai/vendor/prompt_toolkit/styles/style.py +401 -0
  160. package/omni_ai/vendor/prompt_toolkit/styles/style_transformation.py +374 -0
  161. package/omni_ai/vendor/prompt_toolkit/token.py +9 -0
  162. package/omni_ai/vendor/prompt_toolkit/utils.py +327 -0
  163. package/omni_ai/vendor/prompt_toolkit/validation.py +192 -0
  164. package/omni_ai/vendor/prompt_toolkit/widgets/__init__.py +63 -0
  165. package/omni_ai/vendor/prompt_toolkit/widgets/base.py +995 -0
  166. package/omni_ai/vendor/prompt_toolkit/widgets/dialogs.py +108 -0
  167. package/omni_ai/vendor/prompt_toolkit/widgets/menus.py +374 -0
  168. package/omni_ai/vendor/prompt_toolkit/widgets/toolbars.py +370 -0
  169. package/omni_ai/vendor/prompt_toolkit/win32_types.py +229 -0
  170. package/omni_ai/vendor/wcwidth/LICENSE +27 -0
  171. package/omni_ai/vendor/wcwidth/__init__.py +29 -0
  172. package/omni_ai/vendor/wcwidth/table_vs16.py +125 -0
  173. package/omni_ai/vendor/wcwidth/table_wide.py +1493 -0
  174. package/omni_ai/vendor/wcwidth/table_zero.py +4843 -0
  175. package/omni_ai/vendor/wcwidth/unicode_versions.py +38 -0
  176. package/omni_ai/vendor/wcwidth/wcwidth.py +345 -0
  177. package/package.json +40 -4
@@ -0,0 +1,630 @@
1
+ # Omni AI CLI
2
+
3
+ ![npm](https://img.shields.io/badge/npm-bient%C3%B4t-1A1714)
4
+ [![License: MIT](https://img.shields.io/badge/license-MIT-C4552F.svg)](../LICENSE)
5
+ ![Plateformes](https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows-1A1714)
6
+ ![Langues](https://img.shields.io/badge/pt--BR%20·%20en%20·%20es%20·%20fr-C4552F)
7
+
8
+ > [Português](../README.md) · [English](README.en.md) · [Español](README.es.md)
9
+
10
+ Un terminal de chat qui réunit **Claude Code, Codex, Cursor, Antigravity, Grok, DeepSeek et
11
+ OpenRouter** au même endroit. Vous écrivez la question, `ai` décide qui répond et, si
12
+ l'outil échoue ou dépasse son quota, il passe au suivant sans que vous ayez rien à faire.
13
+
14
+ Pendant qu'une réponse est générée, la zone de saisie reste libre : vous continuez à
15
+ envoyer des demandes, qui entrent dans une file visible au-dessus de la zone et
16
+ s'exécutent dans l'ordre.
17
+
18
+ Les questions simples vont vers les outils les moins chers. Les tâches lourdes vont vers
19
+ Claude, avec bascule automatique entre plusieurs comptes quand l'un atteint sa limite.
20
+ L'historique est sauvegardé, l'interface parle portugais, anglais, espagnol et français,
21
+ et les modèles comme les comptes se configurent depuis le chat lui-même.
22
+
23
+ ---
24
+
25
+ ## Sommaire
26
+
27
+ - [Comment ça marche](#comment-ça-marche)
28
+ - [Installation](#installation)
29
+ - [Utilisation](#utilisation)
30
+ - [Commandes du chat](#commandes-du-chat)
31
+ - [Modèles](#modèles)
32
+ - [Comptes Claude](#comptes-claude)
33
+ - [Clés API](#clés-api)
34
+ - [Modes](#modes)
35
+ - [Skills et MCP](#skills-et-mcp)
36
+ - [Utilisation directe, sans chat](#utilisation-directe-sans-chat)
37
+ - [Emplacement des fichiers](#emplacement-des-fichiers)
38
+ - [Structure du projet](#structure-du-projet)
39
+ - [Tests](#tests)
40
+ - [Dépannage](#dépannage)
41
+ - [Limitations connues](#limitations-connues)
42
+ - [Confidentialité](#confidentialité)
43
+ - [Licence](#licence)
44
+
45
+ ---
46
+
47
+ ## Comment ça marche
48
+
49
+ De la ligne saisie jusqu'à la réponse sauvegardée. Le chat (`chat.py`) n'appelle
50
+ aucune IA directement : il lance le routeur (`cli.py`) comme sous-processus et lit
51
+ les événements qu'il émet, ligne par ligne, pour afficher qui répond et ce qu'il fait.
52
+
53
+ ```mermaid
54
+ flowchart TD
55
+ A["Vous saisissez et appuyez sur Entrée<br/>(la zone ne se bloque jamais)"] --> B{"Commence par / ?"}
56
+ B -- oui --> C["Commande interne<br/>/model · /account · /key · /lang · /versions"]
57
+ C --> C1["config.py écrit dans<br/>models.json, profiles.json ou keys/"]
58
+ B -- non --> FQ["Entre dans la file<br/>avec l'outil choisi au moment de l'envoi"]
59
+
60
+ subgraph CHAT ["chat.py — chat"]
61
+ FQ --> FW{"A attendu dans la file et la réponse<br/>précédente règle déjà la demande ?"}
62
+ FW -- "oui (classifieur gratuit)" --> FS["Ignorée, signalé à l'écran"]
63
+ FW -- non --> D["Construit le contexte : derniers messages<br/>de la session jusqu'à 48 mille caractères + langue"]
64
+ D --> E["Worker en thread lance le routeur<br/>dans son propre groupe de processus"]
65
+ E -. "événements JSON ligne par ligne" .-> F["Affiche le fournisseur, les commandes et la réponse"]
66
+ X["Ctrl-C"] -. "vide la file ; SIGTERM sur le groupe,<br/>après 5 s, SIGKILL" .-> E
67
+ end
68
+
69
+ subgraph ROUTER ["cli.py — routeur"]
70
+ E --> G["Charge les modèles :<br/>env > models.json > défaut"]
71
+ G --> H{"Outil fixé<br/>avec /tool ?"}
72
+ H -- oui --> H1["Seulement l'outil choisi"]
73
+ H -- auto --> I{"Classe : Groq → Cerebras →<br/>OpenRouter gratuit → Grok ;<br/>sans réponse, mots-clés"}
74
+ I -- simple --> J["OpenRouter : gratuits, ou payants<br/>si autorisés · données personnelles masquées"]
75
+ J -- "sans clé ou échec" --> K["Codex : abonnement,<br/>puis clé d'API"]
76
+ K -- échec --> L["Antigravity : abonnement,<br/>puis clé d'API"]
77
+ L -- échec --> LP["Payants seulement si listés dans fallback_order :<br/>Cursor, Grok, DeepSeek"]
78
+ LP -- échec --> M
79
+ I -- complexe --> M["Claude : prochain compte actif<br/>par priorité"]
80
+ M --> N{"Rate limit ?"}
81
+ N -- oui --> O["Compte en cooldown de 60 min"]
82
+ O --> P{"Un autre compte<br/>disponible ?"}
83
+ P -- oui --> M
84
+ P -- non --> PK{"Clé d'API<br/>Anthropic ?"}
85
+ PK -- oui --> PK1["Claude avec ANTHROPIC_API_KEY"]
86
+ PK1 -- ok --> R
87
+ PK1 -- échec --> Q
88
+ PK -- non --> Q["Dernier recours :<br/>Codex, puis Antigravity"]
89
+ end
90
+
91
+ N -- non --> R["Réponse"]
92
+ J -- ok --> R
93
+ K -- ok --> R
94
+ L -- ok --> R
95
+ LP -- ok --> R
96
+ Q --> R
97
+ H1 --> R
98
+ R --> F
99
+ F --> S[("Session sauvegardée sur disque<br/>avec écriture atomique")]
100
+ S --> FQ
101
+ ```
102
+
103
+ Trois détails que le diagramme rend explicites :
104
+
105
+ - **Chaque compte Claude a son propre dossier de connexion.** Les comptes
106
+ supplémentaires s'exécutent avec `CLAUDE_CONFIG_DIR` pointant vers
107
+ `~/.claude-accounts/<nom>`. Le compte principal n'est jamais déconnecté, et aucun
108
+ identifiant n'est copié d'un endroit à un autre. Copier le `.credentials.json` ne
109
+ fonctionne pas de façon fiable sur macOS, où la connexion est stockée dans le
110
+ Keychain.
111
+ - **Ctrl-C tue tout l'arbre de processus.** Le routeur s'exécute dans son propre groupe de
112
+ processus ; annuler arrête donc aussi le `claude`, le `codex` ou le `agy` qui tourne en
113
+ dessous, au lieu de laisser des processus orphelins consommer du quota.
114
+ - **La file ne bloque rien.** Au-dessus de la zone s'affichent la demande en cours, le
115
+ temps écoulé et les suivantes. Une demande qui a attendu passe par un classifieur gratuit
116
+ avant de s'exécuter : si la réponse précédente la règle déjà, elle est ignorée. Les
117
+ commandes et skills s'exécutent toujours. Ctrl-C avec la file active annule tout sans
118
+ quitter le chat. Si vous fermez le chat avec des demandes en attente, elles restent
119
+ enregistrées dans la session et `ai --resume ID` propose de les relancer.
120
+ - **Chaque réponse indique son coût.** À la fin de chaque demande s'affichent les tokens et,
121
+ quand l'outil le fournit (OpenRouter, Grok, Claude avec clé API), le coût en dollars.
122
+ `/usage` additionne la dépense du jour par outil.
123
+ - **Vous voyez pourquoi l'outil a été choisi.** En mode `auto`, une ligne courte indique si la
124
+ demande a été traitée comme une tâche de code ou une question simple, et qui l'a classée
125
+ (Groq, Cerebras, OpenRouter, Grok ou les mots-clés).
126
+ - **Seule la réponse entre dans l'historique.** Les lignes de statut et de diagnostic
127
+ s'affichent à l'écran, mais ne sont pas envoyées comme contexte à la question suivante.
128
+ Le raisonnement interne des modèles est aussi écarté.
129
+
130
+ ---
131
+
132
+ ## Installation
133
+
134
+ Une commande installe tout et, relancée, met à jour. Vos comptes, clés et modèles restent dans `~/.config/smart-ai` et ne sont pas touchés.
135
+
136
+ **macOS et Linux**:
137
+
138
+ ```bash
139
+ curl -fsSL https://raw.githubusercontent.com/samuelrms/omni-ai-cli/main/get.sh | bash
140
+ ```
141
+
142
+ **Windows** (PowerShell):
143
+
144
+ ```powershell
145
+ irm https://raw.githubusercontent.com/samuelrms/omni-ai-cli/main/get.ps1 | iex
146
+ ```
147
+
148
+ **Bientôt sur npm, yarn, pnpm et bun.** Le paquet `omni-ai-cli` est prêt et sera publié dès que possible :
149
+
150
+ ```bash
151
+ npm install -g omni-ai-cli
152
+ yarn global add omni-ai-cli
153
+ pnpm add -g omni-ai-cli
154
+ bun add -g omni-ai-cli
155
+ ```
156
+
157
+ En attendant, utilisez la commande macOS/Linux ou Windows ci-dessus.
158
+
159
+ Pour mettre à jour ensuite : `ai --update` (ou `/update` dans le chat).
160
+
161
+ Depuis les sources, pour développer :
162
+
163
+ ```bash
164
+ git clone https://github.com/samuelrms/omni-ai-cli ~/dev/omni-ai-cli
165
+ cd ~/dev/omni-ai-cli && ./scripts/install.sh # Windows: powershell -File scripts\install.ps1
166
+ ```
167
+
168
+ L'installateur :
169
+
170
+ 1. installe **Claude Code** avec l'installateur officiel s'il n'est pas encore sur la machine ;
171
+ 2. ouvre la connexion du compte principal s'il n'y en a pas encore ;
172
+ 3. crée la commande `ai` dans `~/.local/bin` ;
173
+ 4. affiche les comptes Claude configurés.
174
+
175
+ Prérequis : rien d'autre que `curl` (macOS/Linux) ou PowerShell (Windows). S'il manque Python 3.11+, l'installateur télécharge un Python 3.12 réservé à Omni AI, sans sudo et sans toucher au Python du système.
176
+ Codex (`codex`) et Antigravity (`agy`) sont optionnels et rejoignent la file des alternatives quand ils sont installés.
177
+
178
+ Si `~/.local/bin` n'est pas dans le `PATH`, ajoutez à `~/.zshrc` :
179
+
180
+ ```bash
181
+ export PATH="$HOME/.local/bin:$PATH"
182
+ ```
183
+
184
+ Sous Windows, l'installateur crée `ai.cmd` dans `%USERPROFILE%\.local\bin` et ajoute ce dossier au `PATH` ; ouvrez un nouveau terminal ensuite.
185
+
186
+ ---
187
+
188
+ ## Utilisation
189
+
190
+ ```bash
191
+ ai
192
+ ```
193
+
194
+ La première fois, il demande la langue et propose d'installer les outils manquants
195
+ (Claude Code, Codex, Cursor, Grok Build) avec les installeurs officiels. Antigravity
196
+ s'installe depuis sa page. Ensuite, il suffit d'écrire et d'appuyer sur Entrée.
197
+
198
+ | Touche | Action |
199
+ | --- | --- |
200
+ | Entrée | Envoie |
201
+ | ↑ / ↓ | Lignes précédentes |
202
+ | Ctrl-C | Pendant la réponse : annule. Au prompt : sauvegarde et quitte |
203
+ | Ctrl-D | Sauvegarde et quitte |
204
+ | `\` + Entrée · Maj+Entrée · Option+Entrée | Nouvelle ligne sans envoyer (Maj+Entrée dans iTerm2, Ghostty, Kitty, WezTerm et VS Code ; dans Terminal macOS, `\` + Entrée) |
205
+ | Tab | Complète commandes et skills |
206
+
207
+ Dans le menu Tab, chaque élément indique à qui il appartient : `omni`, `claude`, `codex` ou `agy`. Quand
208
+ vous choisissez une skill avec arguments (comme `/pr-review [pr-number | --branch]`), le chat les
209
+ demande : Tab montre les options, vous pouvez écrire votre propre texte, et Entrée seule la lance sans arguments.
210
+
211
+ L'écran suit le style de Claude Code et Codex : zone de saisie en bas avec barre d'état (outil,
212
+ modèle, mode et dossier), Tab pour compléter commandes et skills, chaque action de l'IA sur une
213
+ ligne (`● Ran …`, `● Edited …`, `● Called …`) avec la sortie repliée, réponses en markdown et un
214
+ indicateur « Au travail… » avec la durée. Au démarrage, un écran d'accueil de 1,5 s en plein écran
215
+ (Ctrl-C le passe ; `SMART_AI_NO_SPLASH=1` le désactive).
216
+
217
+ À la sortie, il affiche la commande pour revenir à la même conversation :
218
+
219
+ ```text
220
+ Sessão salva. Retome com: ai --resume 1f3a9c2b7d40
221
+ ```
222
+
223
+ ---
224
+
225
+ ## Commandes du chat
226
+
227
+ | Commande | Ce qu'elle fait |
228
+ | --- | --- |
229
+ | `/tool auto\|claude\|codex\|cursor\|agy\|openrouter\|grok\|deepseek` | Fixe un outil (`auto` décide tout seul) |
230
+ | `/model` | Liste les modèles de chaque outil |
231
+ | `/model codex gpt-6-astra` | Change un modèle |
232
+ | `/model codex default` | Revient au défaut |
233
+ | `/account` | Liste les comptes Claude et indique s'ils sont connectés |
234
+ | `/account add pessoal` | Crée un compte et ouvre la connexion Claude sur-le-champ |
235
+ | `/account login NOME` | Refait la connexion d'un compte |
236
+ | `/account sync NOM` | Repartage les skills, plugins et MCP du compte principal |
237
+ | `/account disable\|enable\|remove NOME` | Désactive, réactive ou supprime |
238
+ | `/key` | Liste les clés d'API configurées (masquées) |
239
+ | `/key claude\|codex\|cursor\|agy\|openrouter\|grok\|deepseek\|groq\|cerebras` | Ajoute une clé, sans afficher ce que vous tapez |
240
+ | `/key add OUTIL [NOM]` | Une clé de plus pour le même outil (tous, Claude compris) ; les clés sont essayées dans l'ordre quand l'une échoue ou atteint sa limite |
241
+ | `/key remove OUTIL [NOM]` | Supprime la clé (sans nom : la principale) |
242
+ | `/status` · `/reset` | Statut des comptes · remet les cooldowns à zéro |
243
+ | `/lang pt\|en\|es\|fr` | Change la langue |
244
+ | `/mode default\|plan\|edits\|auto\|yolo` | Mode de permissions, identique sur les trois outils |
245
+ | `/sync` | Partage MCP et skills entre Claude, Codex et Antigravity |
246
+ | `/usage [watch]` · `/limits` | Usage réel de chaque compte en barres (e-mail, offre, % des fenêtres de 5 h et hebdomadaire, heure de remise à zéro) pour Claude et Codex ; dépense de la clé sur OpenRouter ; pour les autres, le message de limite de l'outil. `watch` rafraîchit toutes les 30 s |
247
+ | `/queue [rm\|up\|down N\|clear]` | Affiche la file ; retire (`rm`), monte (`up`), descend (`down`) une demande ou vide (`clear`) ce qui attend |
248
+ | `/versions [N]` | Ce qui a changé dans chaque version, la plus récente d'abord ; `N` ouvre la note technique. Avant la première release, affiche les `feat`/`fix` de `main`. Les titres s'affichent dans la langue du chat (traduits par les classificateurs gratuits et mis en cache). À l'ouverture du chat, une ligne signale une nouvelle version. |
249
+ | `/clear` · `/compact` | Effacer la conversation · la résumer en un bloc pour économiser du contexte |
250
+ | `/claude:usage` · `/codex:status` · `/agy:usage` … | Commandes natives de chaque outil : ouvre son écran et revient à Omni en sortant |
251
+ | `/setup [install]` | Guide de démarrage : ce qu'il reste à installer, connecter et configurer ; `install` installe les outils manquants |
252
+ | `/terminal-setup` | Montre comment avoir Maj+Entrée (ou Option+Entrée) pour une nouvelle ligne dans votre terminal |
253
+ | `/skills` | Liste les skills et commandes du projet et de l'utilisateur (Claude, Codex, Antigravity) |
254
+ | `/nom args` | Lance la skill ou la commande (ex. `/pr-review 237`). Tab complète |
255
+ | `/history` · `/sent` · `/trace` | Conversation · ce qui a été envoyé · événements de l'exécution |
256
+ | `/sessions` · `/resume ID` · `/new` | Sessions sauvegardées |
257
+ | `/parallel codex: tarefa \| deepseek: tarefa` | 2 à 4 analyses en parallèle, en lecture seule (codex, openrouter, grok, deepseek) |
258
+ | `/help` · `/exit` | Aide · quitter |
259
+
260
+ Pendant que la file tourne, `/clear`, `/new`, `/resume`, `/key`, `/usage` et les commandes
261
+ natives attendent : elles prennent le terminal ou changent de session. Le reste fonctionne
262
+ tout de suite.
263
+
264
+ Les commandes de configuration fonctionnent aussi hors du chat : `ai --model`,
265
+ `ai --account add pessoal`, `ai --key claude`, `ai --status`, `ai --reset`.
266
+
267
+ ---
268
+
269
+ ## Modèles
270
+
271
+ | Clé | Défaut | Valeurs acceptées |
272
+ | --- | --- | --- |
273
+ | `claude` | `opus` (le plus capable) | `opus`, `sonnet`, `haiku` ou ID complet |
274
+ | `codex` | `gpt-6-astra` | ID de modèle Codex |
275
+ | `codex_effort` | `high` | `minimal`, `low`, `medium`, `high`, `xhigh` |
276
+ | `agy` | défaut d'Antigravity | ID de modèle Antigravity |
277
+ | `openrouter` | automatique (gratuit) | ID du modèle ; payant seulement avec `openrouter_paid on` |
278
+ | `openrouter_paid` | `off` | `on` autorise les modèles payants d'OpenRouter |
279
+ | `grok` | défaut de Grok | ID de modèle xAI |
280
+ | `deepseek` | `deepseek-chat` | `deepseek-chat`, `deepseek-reasoner` |
281
+ | `cursor` | défaut du compte Cursor | ID de modèle du Cursor CLI |
282
+
283
+ L'ordre de priorité est : variable d'environnement, puis ce qui a été sauvegardé avec
284
+ `/model` (dans `~/.config/smart-ai/models.json`), puis le défaut. Les variables sont
285
+ `SMART_AI_CLAUDE_MODEL`, `SMART_AI_CODEX_MODEL`, `SMART_AI_CODEX_EFFORT`,
286
+ `SMART_AI_AGY_MODEL`, `SMART_AI_OPENROUTER_MODEL`, `SMART_AI_GROK_MODEL`,
287
+ `SMART_AI_DEEPSEEK_MODEL` et `SMART_AI_CURSOR_MODEL`. Quand l'une d'elles est définie,
288
+ `/model` signale qu'elle est prioritaire.
289
+
290
+ ---
291
+
292
+ ## Comptes Claude
293
+
294
+ ```text
295
+ ai [auto] › /account add trabalho
296
+ Abrindo login do Claude para a conta "trabalho" (pasta isolada ~/.claude-accounts/trabalho).
297
+ Sua conta principal não é afetada.
298
+ ✓ Conta "trabalho" adicionada com prioridade 3.
299
+ ```
300
+
301
+ Les comptes sont essayés par ordre de priorité. Celui qui atteint sa limite passe en
302
+ cooldown (60 minutes par défaut, réglable dans `profiles.json`) et le suivant prend le
303
+ relais. Le compte `primary` utilise la connexion normale de Claude (`claude auth login`).
304
+
305
+ Les skills, plugins, agents, `CLAUDE.md`, `settings.json` et les serveurs MCP du compte
306
+ principal sont partagés avec chaque compte supplémentaire à la connexion. Seule la
307
+ connexion reste séparée. Si vous installez une nouvelle skill ou un nouveau MCP ensuite,
308
+ lancez `/account sync NOM`.
309
+
310
+
311
+ ---
312
+
313
+ ## Clés API
314
+
315
+ En plus des abonnements, chaque outil accepte une clé d'API. **L'abonnement passe en
316
+ premier** ; la clé n'intervient que lorsque l'abonnement échoue ou atteint sa limite,
317
+ car une clé est facturée à l'usage. OpenRouter fonctionne uniquement avec une clé.
318
+
319
+ | Outil | Commande | Variable reçue par le CLI | Où la créer |
320
+ | --- | --- | --- | --- |
321
+ | Claude | `/key claude` | `ANTHROPIC_API_KEY` | console.anthropic.com/settings/keys |
322
+ | Codex | `/key codex` | `CODEX_API_KEY` | platform.openai.com/api-keys |
323
+ | Antigravity | `/key agy` | `GEMINI_API_KEY` | aistudio.google.com/apikey |
324
+ | OpenRouter | `/key openrouter` | `OPENROUTER_API_KEY` | openrouter.ai/keys |
325
+ | Cursor | `/key cursor` | `CURSOR_API_KEY` | cursor.com/dashboard → Integrations |
326
+ | Grok | `/key grok` | `XAI_API_KEY` | console.x.ai |
327
+ | DeepSeek | `/key deepseek` | `DEEPSEEK_API_KEY` | platform.deepseek.com/api_keys |
328
+ | Groq (classifieur) | `/key groq` | `GROQ_API_KEY` | console.groq.com/keys |
329
+ | Cerebras (classifieur) | `/key cerebras` | `CEREBRAS_API_KEY` | cloud.cerebras.ai |
330
+
331
+ Cursor utilise d'abord la connexion du compte (`cursor-agent login`), puis seulement les
332
+ clés. DeepSeek, comme OpenRouter, ne fonctionne qu'avec une clé et masque les données
333
+ personnelles avant l'envoi. Groq et Cerebras ne répondent pas aux questions : ils classent
334
+ seulement chaque demande (gratuitement) et vérifient si une demande de la file a déjà été
335
+ traitée.
336
+
337
+ ```text
338
+ ai [auto] › /key claude
339
+ Chave de claude (console.anthropic.com/settings/keys). Cole e tecle Enter; ela não aparece na tela.
340
+ >
341
+ ✓ Chave de claude salva em ~/.config/smart-ai/keys/claude (permissão 600).
342
+ ```
343
+
344
+ Les clés sont stockées dans `~/.config/smart-ai/keys/`, une par fichier, avec la
345
+ permission 600, et ne sont transmises qu'au processus de l'outil, jamais à l'historique
346
+ ni au journal. Si la variable est déjà définie dans l'environnement, elle est
347
+ prioritaire. `/key` liste ce qui est configuré, en n'affichant que le début et la fin de
348
+ chaque clé.
349
+
350
+ Pour Claude, la clé fonctionne comme un compte supplémentaire placé après tous les
351
+ abonnements : si elle atteint elle aussi sa limite, elle passe en cooldown comme les
352
+ autres.
353
+
354
+ > **Ne collez jamais une clé comme commande dans le shell.** Elle reste enregistrée dans
355
+ > l'historique de zsh. Si cela arrive, révoquez la clé sur le site de l'outil et
356
+ > supprimez la ligne de `~/.zsh_history`.
357
+
358
+ Sur OpenRouter, par défaut seuls les modèles gratuits sont utilisés : le client choisit
359
+ jusqu'à trois variantes `:free` du catalogue et utilise `openrouter/free` en dernière
360
+ alternative. Les modèles payants restent bloqués tant que vous ne les autorisez pas :
361
+
362
+ ```text
363
+ /model openrouter_paid on # autorise ; prévient que ce sera facturé sur votre compte
364
+ /model openrouter anthropic/claude-opus-5.5
365
+ /model openrouter_paid off # bloque à nouveau et revient au gratuit
366
+ ```
367
+
368
+ Avec l'autorisation active, le modèle choisi passe en premier et les gratuits restent en
369
+ secours. Désactivée, un plafond de prix à zéro est envoyé à chaque appel : aucun modèle
370
+ payant ne répond.
371
+
372
+ ---
373
+
374
+ ## Modes
375
+
376
+ Le mode s'applique à Claude, Codex et Antigravity en même temps et s'affiche dans le
377
+ prompt (`ai [auto · plan] ›`). Chaque session garde le sien.
378
+
379
+ | Mode | Effet | Claude | Codex | Antigravity |
380
+ | --- | --- | --- | --- | --- |
381
+ | `default` | Comportement par défaut de chaque outil | — | — | — |
382
+ | `plan` | Lit et planifie seulement, ne modifie rien | `plan` | `--sandbox read-only` | `--mode plan` |
383
+ | `edits` | Accepte les modifications de fichiers | `acceptEdits` | `--sandbox workspace-write` | `--mode accept-edits` |
384
+ | `auto` | Agit seul, avec les protections de l'outil | `auto` | `workspace-write`, sans approbation | `--mode auto` |
385
+ | `yolo` | Sans permissions ni sandbox | `bypassPermissions` | `--dangerously-bypass-approvals-and-sandbox` | `--dangerously-skip-permissions` |
386
+
387
+ `/mode yolo` demande une confirmation, car l'IA peut alors supprimer des fichiers et lancer
388
+ n'importe quelle commande. Hors du chat : `ai --mode plan "question"`. `/parallel` tourne
389
+ toujours en `plan`.
390
+
391
+ ---
392
+
393
+ ## Skills et MCP
394
+
395
+ `ai` appelle les CLI eux-mêmes, donc chacun utilise les skills et MCP qu'il a déjà.
396
+ `/sync` rassemble tout et installe dans chaque outil ce qui n'existe que dans les autres :
397
+
398
+ ```text
399
+ ai [auto] › /sync
400
+ Ferramentas encontradas: claude, codex, agy
401
+ MCP github codex → claude
402
+ MCP obsidian claude → codex
403
+ skill humanizer claude → codex (~/.agents/skills/humanizer)
404
+ Aplicar? [s/N]
405
+ ```
406
+
407
+ - Les MCP sont ajoutés via la commande `mcp add` de chaque CLI, sans éditer de fichiers.
408
+ - Un même serveur sous des noms différents est reconnu par paquet ou URL et n'est pas dupliqué.
409
+ - Les MCP fournis dans une app (comme ceux de Codex.app) y restent.
410
+ - Les skills sont partagées par lien : `~/.claude/skills`, `~/.agents/skills` (Codex) et
411
+ `~/.gemini/antigravity/skills`. Modifier l'une vaut pour les trois.
412
+ - Les comptes Claude supplémentaires sont mis à jour aussi.
413
+ - Les variables d'environnement des MCP, qui peuvent contenir des jetons, sont copiées dans
414
+ la config de l'autre outil. `/sync` prévient avant.
415
+ - `/sync --dry-run` montre seulement ce qu'il ferait.
416
+
417
+ **Skills et commandes du projet :** le chat lit `.claude/commands`, `.claude/skills`, `.agents/skills` et
418
+ `.agent/workflows` du projet ouvert, en plus des dossiers de l'utilisateur. `/pr-review 237` part vers
419
+ Claude tel quel, et Claude exécute la commande nativement. Une skill qui n'existe que dans Codex
420
+ ou Antigravity part vers cet outil, avec les instructions du fichier dans la demande.
421
+
422
+ Comme le chat ne relaie pas les demandes d'approbation, un outil MCP ne s'exécute que s'il
423
+ est déjà autorisé dans le CLI ou si le mode est `auto` ou `yolo`. OpenRouter n'a ni skills
424
+ ni MCP.
425
+
426
+ ---
427
+
428
+ ## Utilisation directe, sans chat
429
+
430
+ ```bash
431
+ ai "o que é um design pattern?" # routage automatique
432
+ ai --claude "refatorar o módulo X" # force Claude
433
+ ai --codex "explicar REST" # force Codex
434
+ ai --agy "pesquisar React hooks" # force Antigravity
435
+ ai --openrouter "explicar Docker" # force OpenRouter
436
+ ai --cursor "corrigir o teste X" # force Cursor
437
+ ai --deepseek "explicar CAP theorem" # force DeepSeek
438
+ ai --install # installe les outils manquants (demande avant)
439
+ ai --classify "prompt" # montre la classification
440
+ ai --log # derniers appels
441
+ ```
442
+
443
+ ---
444
+
445
+ ## Emplacement des fichiers
446
+
447
+ | Chemin | Contenu |
448
+ | --- | --- |
449
+ | `~/.config/smart-ai/profiles.json` | Comptes Claude et règles de routage |
450
+ | `~/.config/smart-ai/models.json` | Modèles choisis avec `/model` |
451
+ | `~/.config/smart-ai/lang` | Langue du chat |
452
+ | `~/.config/smart-ai/keys/<ferramenta>` | Clés d'API, une par fichier (permission 600) |
453
+ | `~/.claude-accounts/<nome>/` | Connexion isolée de chaque compte Claude supplémentaire |
454
+ | `~/.local/share/smart-ai/sessions/` | Sessions du chat |
455
+ | `~/.cache/smart-ai/state.json` | Cooldowns actifs |
456
+ | `~/.cache/smart-ai/usage.log` | Journal d'utilisation, métadonnées uniquement |
457
+ | `~/.cache/smart-ai/costs.jsonl` | Coût et tokens de chaque demande du chat, sans question ni réponse (total du jour dans `/usage`) |
458
+
459
+ ---
460
+
461
+ ## Structure du projet
462
+
463
+ ```text
464
+ omni-ai-cli/
465
+ ├── omni_ai/ # le programme (paquet Python)
466
+ │ ├── tools.py # registre unique des outils : nom, couleur, CLI, modèle, clé
467
+ │ ├── cli.py # commande ai : classe, route et exécute chaque outil
468
+ │ ├── chat.py # chat : sessions, événements, Ctrl-C, langues
469
+ │ ├── ui.py # rendu : saisie, barre d'état, actions et réponses
470
+ │ ├── skills.py # skills et commandes du projet, de l'utilisateur et natives
471
+ │ ├── config.py # modèles, clés et comptes Claude (/model, /key, /account)
472
+ │ ├── sync.py # /sync : MCP et skills entre les trois outils
473
+ │ ├── openrouter.py # client OpenRouter : gratuits, payants seulement si autorisés
474
+ │ ├── grok.py # client xAI, réutilisé par DeepSeek
475
+ │ ├── deepseek.py # client DeepSeek avec données personnelles masquées
476
+ │ ├── pii.py # masque et restaure les données personnelles
477
+ │ ├── osutils.py # différences entre macOS, Linux et Windows
478
+ │ ├── profiles.json # modèle initial ; le vôtre est dans ~/.config/smart-ai
479
+ │ └── vendor/ # prompt_toolkit et wcwidth intégrés (sans pip)
480
+ ├── bin/ai.js # lanceur npm : trouve ou installe Python et lance le paquet
481
+ ├── scripts/ # install.sh, install.ps1 et ai.cmd
482
+ ├── docs/ # README en anglais, espagnol et français
483
+ ├── tests/ # exécutables fictifs, sans consommer de quota
484
+ ├── postman/ # simulation HTTP d'OpenRouter
485
+ ├── get.sh / get.ps1 # installation en une commande
486
+ └── package.json · LICENSE
487
+ ```
488
+
489
+ Le routeur ne sait rien du chat : il exécute seulement une question et, avec
490
+ `SMART_AI_EVENTS=1`, émet des événements JSON. Le chat ne sait rien des identifiants :
491
+ comptes et modèles passent par `config.py`.
492
+
493
+ ---
494
+
495
+ ## Tests
496
+
497
+ ```bash
498
+ python3 -m unittest discover -s tests -v
499
+ bash -n scripts/install.sh
500
+ ```
501
+
502
+ **38 tests** : persistance et reprise de session, limite de contexte, permissions des
503
+ fichiers, session ouverte dans deux terminaux, lecture des événements, annulation de
504
+ l'arbre de processus, parallélisme réel, sandbox en lecture seule, masquage des données
505
+ personnelles, fallback OpenRouter → Codex, validation des modèles, stockage des clés et
506
+ cycle de vie des comptes. Tous les exécutables sont factices : **aucun test
507
+ n'authentifie ni ne consomme d'abonnement.**
508
+
509
+ Pour tester le HTTP d'OpenRouter contre la simulation Postman :
510
+
511
+ ```bash
512
+ postman simulation run postman/simulations/openrouter.sim.yaml --port 4901 --no-history --output ndjson
513
+ SMART_AI_SIM_URL=http://127.0.0.1:4901/openrouter python3 -m unittest discover -s tests -v
514
+ ```
515
+
516
+ ---
517
+
518
+ ## Releases et branches
519
+
520
+ La publication sur npm est automatique, faite par GitHub Actions avec semantic-release.
521
+ La version découle des messages de commit (Conventional Commits) — personne ne modifie
522
+ `version` dans `package.json` à la main.
523
+
524
+ | Branche | Publie comme | Exemple |
525
+ |---|---|---|
526
+ | `main` | `latest` | `1.4.0` |
527
+ | `next` | `next` (release candidate) | `1.5.0-rc.1` |
528
+ | `beta` | `beta` | `2.0.0-beta.1` |
529
+ | autres / PR | rien, CI seulement | — |
530
+
531
+ | Commit | Effet sur la version |
532
+ |---|---|
533
+ | `fix: ...` | patch (`1.4.0` → `1.4.1`) |
534
+ | `feat: ...` | minor (`1.4.0` → `1.5.0`) |
535
+ | `feat!: ...` ou `BREAKING CHANGE:` dans le corps | major (`1.4.0` → `2.0.0`) |
536
+ | `docs:`, `ci:`, `chore:`, `test:`, `refactor:` | pas de release |
537
+
538
+ Utilisez le squash merge : le titre de la PR devient le commit, et le workflow `PR title`
539
+ bloque les titres hors convention.
540
+
541
+ ### Messages de commit
542
+
543
+ `/versions` affiche le titre de chaque `feat`/`fix` comme « vue simple » et le corps comme
544
+ « note technique ». Donc :
545
+
546
+ - **Titre :** ce qui change pour l'utilisateur, en anglais, au présent, sans nom de
547
+ fichier ni de fonction. `feat: keep the input free and queue new requests while one runs`,
548
+ pas `feat: add Queue class to chat.py`.
549
+ - **Corps :** le pourquoi et le nouveau comportement en phrases courtes ; les détails
550
+ techniques seulement à la fin, s'ils aident.
551
+ - Un commit par changement perceptible. Refactorisations et tests vont dans
552
+ `refactor:`/`test:`, qui n'apparaissent pas dans `/versions`.
553
+
554
+ ```mermaid
555
+ flowchart TD
556
+ A[PR ouverte] --> B[CI : tests Python 3.11-3.13 sur Linux et macOS<br/>+ npm pack + launcher]
557
+ A --> C[PR title : Conventional Commits ?]
558
+ B -->|échec| X[Merge bloqué]
559
+ C -->|invalide| X
560
+ B -->|ok| D[Squash merge dans main / next / beta]
561
+ C -->|ok| D
562
+ D --> E[Release : la CI tourne à nouveau]
563
+ E -->|échec| Y[Rien n'est publié]
564
+ E -->|ok| F{semantic-release :<br/>feat/fix/breaking<br/>depuis le dernier tag ?}
565
+ F -->|non| Z[Pas de release]
566
+ F -->|oui| G[Calcule la version et crée le tag vX.Y.Z]
567
+ G --> H[npm publish avec provenance<br/>sur le dist-tag de la branche]
568
+ G --> I[GitHub Release avec notes]
569
+ ```
570
+
571
+ Configuration unique sur GitHub :
572
+
573
+ 1. **Settings → Secrets and variables → Actions** : créer `NPM_TOKEN` (jeton *Automation*
574
+ ou *Granular* npmjs.com avec droit de publish).
575
+ 2. **Settings → Branches** : protéger `main` (et `next`/`beta` si utilisées) en exigeant
576
+ une PR et les checks `Tests (...)`, `npm package` et `conventional`.
577
+ 3. **Settings → General → Pull Requests** : n'autoriser que le *squash merging* et cocher
578
+ *Default to pull request title*.
579
+
580
+ ---
581
+
582
+ ## Dépannage
583
+
584
+ | Problème | Solution |
585
+ | --- | --- |
586
+ | `OPENROUTER_API_KEY não configurada` | `/key openrouter` dans le chat ou `ai --key openrouter`. |
587
+ | `Arquivo de credenciais não encontrado` ou `Conta 'X' sem login` | `/account login X`. |
588
+ | `You've hit your session limit` | Quota du compte. `ai` passe au suivant ; ajoutez-en un autre avec `/account add` ou une clé avec `/key claude`. |
589
+ | `Individual quota reached` (Antigravity) | Quota d'Antigravity ; il est ignoré jusqu'au renouvellement. |
590
+ | `Not inside a trusted directory` (Codex) | Ancienne installation. Relancez l'installateur. |
591
+ | `Claude Code não instalado` | `./scripts/install.sh` (ou `scripts\install.ps1` sous Windows) l'installe avec l'installateur officiel. |
592
+ | Windows : les liens de skills échouent | Activez le mode développeur ou lancez en administrateur ; sinon `ai` utilise des jonctions de dossier. |
593
+ | `/model` ne change rien | Une variable `SMART_AI_*_MODEL` est définie et elle est prioritaire. |
594
+ | `/key` ne change rien | La variable de l'outil (`ANTHROPIC_API_KEY` etc.) est définie et elle est prioritaire. |
595
+ | `Sessão já aberta em outro terminal` | Fermez l'autre terminal ou utilisez `/new`. |
596
+ | `ai: command not found` | Ajoutez `~/.local/bin` au `PATH`. |
597
+
598
+ ---
599
+
600
+ ## Limitations connues
601
+
602
+ - Le chat utilise les modes non interactifs des CLI. Les demandes d'approbation natives
603
+ (par exemple « puis-je modifier ce fichier ? ») n'apparaissent pas ; dans ces cas,
604
+ utilisez le CLI natif.
605
+ - `/parallel` ne fait qu'analyser : Codex en `--sandbox read-only` ou OpenRouter, qui
606
+ n'accède pas aux fichiers. Les agents ne modifient pas le projet en même temps.
607
+ - La classification simple/complexe repose sur des mots-clés et la taille, pas sur un
608
+ modèle.
609
+ - Changer de modèle ne renouvelle pas le quota du compte.
610
+ - OpenRouter n'a pas de streaming dans cette version : la réponse apparaît en entier à
611
+ la fin.
612
+ - Sous Windows le code utilise les équivalents natifs (groupes de processus et `taskkill`, `msvcrt`, jonctions de dossier), mais il n'a été testé pour de vrai que sous macOS.
613
+
614
+ ---
615
+
616
+ ## Confidentialité
617
+
618
+ - Les sessions, clés d'API et journaux restent uniquement sur votre machine, avec une permission limitée à votre utilisateur.
619
+ - Le journal d'utilisation enregistre l'outil, le compte et le statut, **jamais le texte de la question**.
620
+ - Avant d'aller vers OpenRouter, e-mails, téléphones, documents et autres données
621
+ personnelles sont remplacés par des marqueurs et restaurés dans la réponse. Le
622
+ masquage repose sur des motifs et ne garantit pas une anonymisation totale.
623
+ - Claude, Codex et Antigravity reçoivent le texte d'origine, selon les conditions de
624
+ chaque service.
625
+
626
+ ---
627
+
628
+ ## Licence
629
+
630
+ [MIT](../LICENSE). Intégrées dans `vendor/` : prompt_toolkit (BSD-3-Clause) et wcwidth (MIT), chacune avec sa licence.
@@ -0,0 +1 @@
1
+ """Omni AI: one chat for Claude Code, Codex, Antigravity and OpenRouter."""
@@ -0,0 +1,6 @@
1
+ """python -m omni_ai: the ai command."""
2
+ import sys
3
+
4
+ from .cli import entry
5
+
6
+ sys.exit(entry())