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.
- package/LICENSE +21 -0
- package/README.md +615 -2
- package/bin/ai.js +84 -0
- package/docs/README.en.md +615 -0
- package/docs/README.es.md +618 -0
- package/docs/README.fr.md +630 -0
- package/omni_ai/__init__.py +1 -0
- package/omni_ai/__main__.py +6 -0
- package/omni_ai/chat.py +1458 -0
- package/omni_ai/cli.py +991 -0
- package/omni_ai/config.py +531 -0
- package/omni_ai/deepseek.py +57 -0
- package/omni_ai/grok.py +111 -0
- package/omni_ai/onboarding.py +196 -0
- package/omni_ai/openrouter.py +335 -0
- package/omni_ai/osutils.py +86 -0
- package/omni_ai/pii.py +281 -0
- package/omni_ai/profiles.json +69 -0
- package/omni_ai/skills.py +124 -0
- package/omni_ai/sync.py +199 -0
- package/omni_ai/tools.py +75 -0
- package/omni_ai/ui.py +595 -0
- package/omni_ai/usage.py +305 -0
- package/omni_ai/vendor/prompt_toolkit/LICENSE +27 -0
- package/omni_ai/vendor/prompt_toolkit/__init__.py +52 -0
- package/omni_ai/vendor/prompt_toolkit/application/__init__.py +32 -0
- package/omni_ai/vendor/prompt_toolkit/application/application.py +1626 -0
- package/omni_ai/vendor/prompt_toolkit/application/current.py +195 -0
- package/omni_ai/vendor/prompt_toolkit/application/dummy.py +55 -0
- package/omni_ai/vendor/prompt_toolkit/application/run_in_terminal.py +114 -0
- package/omni_ai/vendor/prompt_toolkit/auto_suggest.py +177 -0
- package/omni_ai/vendor/prompt_toolkit/buffer.py +2029 -0
- package/omni_ai/vendor/prompt_toolkit/cache.py +127 -0
- package/omni_ai/vendor/prompt_toolkit/clipboard/__init__.py +17 -0
- package/omni_ai/vendor/prompt_toolkit/clipboard/base.py +109 -0
- package/omni_ai/vendor/prompt_toolkit/clipboard/in_memory.py +44 -0
- package/omni_ai/vendor/prompt_toolkit/clipboard/pyperclip.py +42 -0
- package/omni_ai/vendor/prompt_toolkit/completion/__init__.py +43 -0
- package/omni_ai/vendor/prompt_toolkit/completion/base.py +438 -0
- package/omni_ai/vendor/prompt_toolkit/completion/deduplicate.py +45 -0
- package/omni_ai/vendor/prompt_toolkit/completion/filesystem.py +118 -0
- package/omni_ai/vendor/prompt_toolkit/completion/fuzzy_completer.py +213 -0
- package/omni_ai/vendor/prompt_toolkit/completion/nested.py +109 -0
- package/omni_ai/vendor/prompt_toolkit/completion/word_completer.py +94 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/__init__.py +0 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/completers/__init__.py +5 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/completers/system.py +64 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/__init__.py +80 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/compiler.py +579 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/completion.py +100 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/lexer.py +94 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/regex_parser.py +279 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/regular_languages/validation.py +60 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/ssh/__init__.py +8 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/ssh/server.py +178 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/telnet/__init__.py +7 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/telnet/log.py +13 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/telnet/protocol.py +209 -0
- package/omni_ai/vendor/prompt_toolkit/contrib/telnet/server.py +428 -0
- package/omni_ai/vendor/prompt_toolkit/cursor_shapes.py +117 -0
- package/omni_ai/vendor/prompt_toolkit/data_structures.py +18 -0
- package/omni_ai/vendor/prompt_toolkit/document.py +1182 -0
- package/omni_ai/vendor/prompt_toolkit/enums.py +19 -0
- package/omni_ai/vendor/prompt_toolkit/eventloop/__init__.py +31 -0
- package/omni_ai/vendor/prompt_toolkit/eventloop/async_generator.py +125 -0
- package/omni_ai/vendor/prompt_toolkit/eventloop/inputhook.py +191 -0
- package/omni_ai/vendor/prompt_toolkit/eventloop/utils.py +101 -0
- package/omni_ai/vendor/prompt_toolkit/eventloop/win32.py +72 -0
- package/omni_ai/vendor/prompt_toolkit/filters/__init__.py +71 -0
- package/omni_ai/vendor/prompt_toolkit/filters/app.py +419 -0
- package/omni_ai/vendor/prompt_toolkit/filters/base.py +261 -0
- package/omni_ai/vendor/prompt_toolkit/filters/cli.py +65 -0
- package/omni_ai/vendor/prompt_toolkit/filters/utils.py +41 -0
- package/omni_ai/vendor/prompt_toolkit/formatted_text/__init__.py +59 -0
- package/omni_ai/vendor/prompt_toolkit/formatted_text/ansi.py +297 -0
- package/omni_ai/vendor/prompt_toolkit/formatted_text/base.py +179 -0
- package/omni_ai/vendor/prompt_toolkit/formatted_text/html.py +145 -0
- package/omni_ai/vendor/prompt_toolkit/formatted_text/pygments.py +32 -0
- package/omni_ai/vendor/prompt_toolkit/formatted_text/utils.py +103 -0
- package/omni_ai/vendor/prompt_toolkit/history.py +306 -0
- package/omni_ai/vendor/prompt_toolkit/input/__init__.py +14 -0
- package/omni_ai/vendor/prompt_toolkit/input/ansi_escape_sequences.py +344 -0
- package/omni_ai/vendor/prompt_toolkit/input/base.py +153 -0
- package/omni_ai/vendor/prompt_toolkit/input/defaults.py +79 -0
- package/omni_ai/vendor/prompt_toolkit/input/posix_pipe.py +118 -0
- package/omni_ai/vendor/prompt_toolkit/input/posix_utils.py +97 -0
- package/omni_ai/vendor/prompt_toolkit/input/typeahead.py +78 -0
- package/omni_ai/vendor/prompt_toolkit/input/vt100.py +309 -0
- package/omni_ai/vendor/prompt_toolkit/input/vt100_parser.py +250 -0
- package/omni_ai/vendor/prompt_toolkit/input/win32.py +749 -0
- package/omni_ai/vendor/prompt_toolkit/input/win32_pipe.py +156 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/__init__.py +22 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/__init__.py +0 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/auto_suggest.py +66 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/basic.py +257 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/completion.py +206 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/cpr.py +30 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/emacs.py +563 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/focus.py +26 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/mouse.py +348 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/named_commands.py +691 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/open_in_editor.py +52 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/page_navigation.py +85 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/scroll.py +190 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/search.py +96 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/bindings/vi.py +2233 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/defaults.py +63 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/digraphs.py +1378 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/emacs_state.py +36 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/key_bindings.py +670 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/key_processor.py +526 -0
- package/omni_ai/vendor/prompt_toolkit/key_binding/vi_state.py +107 -0
- package/omni_ai/vendor/prompt_toolkit/keys.py +222 -0
- package/omni_ai/vendor/prompt_toolkit/layout/__init__.py +147 -0
- package/omni_ai/vendor/prompt_toolkit/layout/containers.py +2738 -0
- package/omni_ai/vendor/prompt_toolkit/layout/controls.py +945 -0
- package/omni_ai/vendor/prompt_toolkit/layout/dimension.py +220 -0
- package/omni_ai/vendor/prompt_toolkit/layout/dummy.py +40 -0
- package/omni_ai/vendor/prompt_toolkit/layout/layout.py +412 -0
- package/omni_ai/vendor/prompt_toolkit/layout/margins.py +304 -0
- package/omni_ai/vendor/prompt_toolkit/layout/menus.py +748 -0
- package/omni_ai/vendor/prompt_toolkit/layout/mouse_handlers.py +56 -0
- package/omni_ai/vendor/prompt_toolkit/layout/processors.py +1010 -0
- package/omni_ai/vendor/prompt_toolkit/layout/screen.py +323 -0
- package/omni_ai/vendor/prompt_toolkit/layout/scrollable_pane.py +494 -0
- package/omni_ai/vendor/prompt_toolkit/layout/utils.py +80 -0
- package/omni_ai/vendor/prompt_toolkit/lexers/__init__.py +21 -0
- package/omni_ai/vendor/prompt_toolkit/lexers/base.py +85 -0
- package/omni_ai/vendor/prompt_toolkit/lexers/pygments.py +328 -0
- package/omni_ai/vendor/prompt_toolkit/log.py +13 -0
- package/omni_ai/vendor/prompt_toolkit/mouse_events.py +85 -0
- package/omni_ai/vendor/prompt_toolkit/output/__init__.py +15 -0
- package/omni_ai/vendor/prompt_toolkit/output/base.py +332 -0
- package/omni_ai/vendor/prompt_toolkit/output/color_depth.py +64 -0
- package/omni_ai/vendor/prompt_toolkit/output/conemu.py +65 -0
- package/omni_ai/vendor/prompt_toolkit/output/defaults.py +106 -0
- package/omni_ai/vendor/prompt_toolkit/output/flush_stdout.py +87 -0
- package/omni_ai/vendor/prompt_toolkit/output/plain_text.py +143 -0
- package/omni_ai/vendor/prompt_toolkit/output/vt100.py +748 -0
- package/omni_ai/vendor/prompt_toolkit/output/win32.py +683 -0
- package/omni_ai/vendor/prompt_toolkit/output/windows10.py +128 -0
- package/omni_ai/vendor/prompt_toolkit/patch_stdout.py +297 -0
- package/omni_ai/vendor/prompt_toolkit/py.typed +0 -0
- package/omni_ai/vendor/prompt_toolkit/renderer.py +814 -0
- package/omni_ai/vendor/prompt_toolkit/search.py +226 -0
- package/omni_ai/vendor/prompt_toolkit/selection.py +58 -0
- package/omni_ai/vendor/prompt_toolkit/shortcuts/__init__.py +46 -0
- package/omni_ai/vendor/prompt_toolkit/shortcuts/dialogs.py +330 -0
- package/omni_ai/vendor/prompt_toolkit/shortcuts/progress_bar/__init__.py +33 -0
- package/omni_ai/vendor/prompt_toolkit/shortcuts/progress_bar/base.py +449 -0
- package/omni_ai/vendor/prompt_toolkit/shortcuts/progress_bar/formatters.py +431 -0
- package/omni_ai/vendor/prompt_toolkit/shortcuts/prompt.py +1513 -0
- package/omni_ai/vendor/prompt_toolkit/shortcuts/utils.py +239 -0
- package/omni_ai/vendor/prompt_toolkit/styles/__init__.py +67 -0
- package/omni_ai/vendor/prompt_toolkit/styles/base.py +184 -0
- package/omni_ai/vendor/prompt_toolkit/styles/defaults.py +236 -0
- package/omni_ai/vendor/prompt_toolkit/styles/named_colors.py +162 -0
- package/omni_ai/vendor/prompt_toolkit/styles/pygments.py +70 -0
- package/omni_ai/vendor/prompt_toolkit/styles/style.py +401 -0
- package/omni_ai/vendor/prompt_toolkit/styles/style_transformation.py +374 -0
- package/omni_ai/vendor/prompt_toolkit/token.py +9 -0
- package/omni_ai/vendor/prompt_toolkit/utils.py +327 -0
- package/omni_ai/vendor/prompt_toolkit/validation.py +192 -0
- package/omni_ai/vendor/prompt_toolkit/widgets/__init__.py +63 -0
- package/omni_ai/vendor/prompt_toolkit/widgets/base.py +995 -0
- package/omni_ai/vendor/prompt_toolkit/widgets/dialogs.py +108 -0
- package/omni_ai/vendor/prompt_toolkit/widgets/menus.py +374 -0
- package/omni_ai/vendor/prompt_toolkit/widgets/toolbars.py +370 -0
- package/omni_ai/vendor/prompt_toolkit/win32_types.py +229 -0
- package/omni_ai/vendor/wcwidth/LICENSE +27 -0
- package/omni_ai/vendor/wcwidth/__init__.py +29 -0
- package/omni_ai/vendor/wcwidth/table_vs16.py +125 -0
- package/omni_ai/vendor/wcwidth/table_wide.py +1493 -0
- package/omni_ai/vendor/wcwidth/table_zero.py +4843 -0
- package/omni_ai/vendor/wcwidth/unicode_versions.py +38 -0
- package/omni_ai/vendor/wcwidth/wcwidth.py +345 -0
- package/package.json +40 -4
|
@@ -0,0 +1,630 @@
|
|
|
1
|
+
# Omni AI CLI
|
|
2
|
+
|
|
3
|
+

|
|
4
|
+
[](../LICENSE)
|
|
5
|
+

|
|
6
|
+

|
|
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."""
|