claude-scionos 4.0.1 → 4.1.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 (5) hide show
  1. package/README.fr.md +126 -111
  2. package/README.md +126 -111
  3. package/index.js +101 -59
  4. package/package.json +1 -1
  5. package/src/routerlab.js +357 -267
package/README.fr.md CHANGED
@@ -1,134 +1,149 @@
1
- # Claude Code pour RouterLab
2
-
3
- `claude-scionos` est un lanceur RouterLab pour le CLI officiel Claude Code. Il conserve l'usage normal de Claude Code, tout en ajoutant un onboarding guidé, le routage de stratégies, le stockage sécurisé du token et une commande `doctor` pour le support client.
4
-
5
- _[🇬🇧 Read in English](./README.md)_
6
-
7
- ## Points clés
8
-
9
- - lancement guidé pour les nouveaux utilisateurs
1
+ # Claude Code pour RouterLab
2
+
3
+ `claude-scionos` est un lanceur RouterLab pour le CLI officiel Claude Code. Il conserve l'usage normal de Claude Code, tout en ajoutant un onboarding guidé, le routage de stratégies, le stockage sécurisé du token et une commande `doctor` pour le support client.
4
+
5
+ _[🇬🇧 Read in English](./README.md)_
6
+
7
+ ## Points clés
8
+
9
+ - lancement guidé pour les nouveaux utilisateurs
10
10
  - `--strategy` pour choisir une stratégie sans menu
11
+ - `--service llm` pour l'accès RouterLab LLM sur invitation
11
12
  - `--no-prompt` pour l'automatisation et la CI
12
13
  - `--list-strategies` pour voir les routes disponibles
13
- - `doctor` pour diagnostiquer rapidement un poste client
14
- - `auth login|status|change|logout|test` pour gérer le token
15
- - proxy local lancé uniquement si une stratégie mappée est choisie
16
-
17
- ## Prérequis
18
-
19
- - Node.js 22 ou plus
14
+ - `doctor` pour diagnostiquer rapidement un poste client
15
+ - `auth login|status|change|logout|test` pour gérer le token
16
+ - proxy local lancé uniquement si une stratégie mappée est choisie
17
+
18
+ ## Prérequis
19
+
20
+ - Node.js 22 ou plus
20
21
  - un token RouterLab depuis [routerlab.ch/keys](https://routerlab.ch/keys)
21
- - sous Windows, Git Bash doit être installé pour Claude Code
22
-
23
- ## Installation
24
-
25
- Exécution directe avec `npx` :
26
-
27
- ```bash
28
- npx claude-scionos
29
- ```
30
-
31
- Ou installation globale :
32
-
33
- ```bash
34
- npm install -g claude-scionos
35
- claude-scionos
36
- ```
37
-
38
- ## Démarrage rapide
39
-
40
- Mode guidé :
41
-
42
- ```bash
43
- npx claude-scionos
44
- ```
45
-
46
- Commandes utiles :
47
-
48
- ```bash
22
+ - ou un token d'invitation pour `--service llm`
23
+ - sous Windows, Git Bash doit être installé pour Claude Code
24
+
25
+ ## Installation
26
+
27
+ Exécution directe avec `npx` :
28
+
29
+ ```bash
30
+ npx claude-scionos
31
+ ```
32
+
33
+ Ou installation globale :
34
+
35
+ ```bash
36
+ npm install -g claude-scionos
37
+ claude-scionos
38
+ ```
39
+
40
+ ## Démarrage rapide
41
+
42
+ Mode guidé :
43
+
44
+ ```bash
45
+ npx claude-scionos
46
+ ```
47
+
48
+ Commandes utiles :
49
+
50
+ ```bash
49
51
  npx claude-scionos --list-strategies
50
52
  npx claude-scionos doctor
51
53
  npx claude-scionos auth login
54
+ npx claude-scionos auth login --service llm
52
55
  npx claude-scionos auth test
53
56
  npx claude-scionos --strategy aws
57
+ npx claude-scionos --service llm --strategy claude-glm-5
54
58
  npx claude-scionos --strategy aws --no-prompt -p "Résume ce dépôt"
55
59
  ```
56
60
 
57
- ## Stratégies
61
+ ## Services
62
+
63
+ - le comportement par défaut utilise `https://routerlab.ch`
64
+ - `--service llm` bascule le lanceur vers `https://llm.routerlab.ch`
65
+ - `llm` est prévu pour un accès sur invitation
66
+ - les tokens enregistrés avec `auth login --service llm` sont stockés séparément du token RouterLab par défaut
67
+ - `llm` expose pour l'instant `claude-glm-5` et `claude-gpt-5.4`
58
68
 
69
+ ## Stratégies
70
+
59
71
  - `default` : utilise Claude Code normalement sans proxy local
60
72
  - `aws` : remappe les familles de modèles Claude vers les variantes Claude AWS de RouterLab
61
73
  - `claude-glm-5` : force toutes les requêtes vers `claude-glm-5`
62
74
  - `claude-minimax-m2.5` : force toutes les requêtes vers `claude-minimax-m2.5`
63
-
64
- Utilise `--list-strategies` pour voir les libellés actuels et la disponibilité réelle quand un token est disponible.
65
-
66
- ## Gestion du token
67
-
68
- Ordre de résolution du token :
69
-
75
+ - `claude-gpt-5.4` : force toutes les requêtes vers `claude-gpt-5.4`
76
+
77
+ Utilise `--list-strategies` pour voir les stratégies disponibles pour le service choisi et leur disponibilité réelle quand un token est disponible.
78
+
79
+ ## Gestion du token
80
+
81
+ Ordre de résolution du token :
82
+
70
83
  1. `ANTHROPIC_AUTH_TOKEN`
71
84
  2. stockage local sécurisé via `claude-scionos auth login`
72
- 3. saisie manuelle en mode guidé
73
-
74
- Backends de stockage sécurisés :
75
-
76
- - Windows : fichier local chiffré via DPAPI, lié à l'utilisateur courant
77
- - macOS : Keychain
78
- - Linux : Secret Service via `secret-tool`
79
-
80
- Gestion du token :
81
-
82
- ```bash
83
- claude-scionos auth login
84
- claude-scionos auth status
85
- claude-scionos auth change
86
- claude-scionos auth logout
87
- claude-scionos auth test
88
- ```
89
-
85
+ 3. stockage local sécurisé spécifique au service via `claude-scionos auth login --service llm`
86
+ 4. saisie manuelle en mode guidé
87
+
88
+ Backends de stockage sécurisés :
89
+
90
+ - Windows : fichier local chiffré via DPAPI, lié à l'utilisateur courant
91
+ - macOS : Keychain
92
+ - Linux : Secret Service via `secret-tool`
93
+
94
+ Gestion du token :
95
+
96
+ ```bash
97
+ claude-scionos auth login
98
+ claude-scionos auth status
99
+ claude-scionos auth change
100
+ claude-scionos auth logout
101
+ claude-scionos auth test
102
+ ```
103
+
90
104
  ## Ce que veulent dire `--strategy` et `--no-prompt`
91
105
 
92
106
  - `--strategy <value>` évite le menu interactif et choisit directement la route
107
+ - `--service <value>` change la cible RouterLab. `routerlab` reste le défaut et `llm` est réservé à l'accès sur invitation
93
108
  - `--no-prompt` désactive toutes les questions interactives
94
-
95
- Quand `--no-prompt` est utilisé, le lanceur doit déjà avoir un token via `ANTHROPIC_AUTH_TOKEN` ou via le stockage sécurisé.
96
-
97
- ## Doctor
98
-
99
- `claude-scionos doctor` vérifie l'installation locale et affiche un résumé exploitable par le support :
100
-
101
- - plateforme et version Node.js
102
- - installation de Claude Code
103
- - Git Bash sous Windows
104
- - backend de stockage sécurisé
105
- - présence d'un token stocké ou d'environnement
106
- - validation RouterLab si un token est disponible
107
-
108
- ## Compatibilité
109
-
110
- Le wrapper transmet les arguments Claude Code habituels. Le proxy local n'est lancé que pour les stratégies mappées. `default` lance Claude Code sans couche proxy.
111
-
112
- ## Dépannage
113
-
114
- `claude-scionos doctor` doit être la première commande à lancer quand un client signale un problème.
115
-
116
- Cas courants :
117
-
118
- - `Claude Code CLI not found` : installer `@anthropic-ai/claude-code`
119
- - `Git Bash is required on Windows` : installer Git for Windows
120
- - `ANTHROPIC_AUTH_TOKEN ... is required when using --no-prompt` : définir la variable d'environnement ou stocker le token au préalable
121
- - `secret-tool not found` : installer un client Secret Service sous Linux ou utiliser la variable d'environnement
122
-
123
- ## Développement
124
-
125
- ```bash
126
- npm install
127
- npm test
128
- npm run lint
129
- node index.js
130
- ```
131
-
132
- ## Licence
133
-
134
- MIT. Voir [LICENSE](./LICENSE).
109
+
110
+ Quand `--no-prompt` est utilisé, le lanceur doit déjà avoir un token via `ANTHROPIC_AUTH_TOKEN` ou via le stockage sécurisé.
111
+
112
+ ## Doctor
113
+
114
+ `claude-scionos doctor` vérifie l'installation locale et affiche un résumé exploitable par le support :
115
+
116
+ - plateforme et version Node.js
117
+ - installation de Claude Code
118
+ - Git Bash sous Windows
119
+ - backend de stockage sécurisé
120
+ - présence d'un token stocké ou d'environnement
121
+ - validation RouterLab si un token est disponible
122
+
123
+ ## Compatibilité
124
+
125
+ Le wrapper transmet les arguments Claude Code habituels. Le proxy local n'est lancé que pour les stratégies mappées. `default` lance Claude Code sans couche proxy.
126
+
127
+ ## Dépannage
128
+
129
+ `claude-scionos doctor` doit être la première commande à lancer quand un client signale un problème.
130
+
131
+ Cas courants :
132
+
133
+ - `Claude Code CLI not found` : installer `@anthropic-ai/claude-code`
134
+ - `Git Bash is required on Windows` : installer Git for Windows
135
+ - `ANTHROPIC_AUTH_TOKEN ... is required when using --no-prompt` : définir la variable d'environnement ou stocker le token au préalable
136
+ - `secret-tool not found` : installer un client Secret Service sous Linux ou utiliser la variable d'environnement
137
+
138
+ ## Développement
139
+
140
+ ```bash
141
+ npm install
142
+ npm test
143
+ npm run lint
144
+ node index.js
145
+ ```
146
+
147
+ ## Licence
148
+
149
+ MIT. Voir [LICENSE](./LICENSE).
package/README.md CHANGED
@@ -1,134 +1,149 @@
1
- # Claude Code for RouterLab
2
-
3
- `claude-scionos` is a RouterLab launcher for the official Claude Code CLI. It keeps the normal Claude Code workflow, while adding guided onboarding, strategy routing, secure token storage, and a `doctor` command for client support.
4
-
5
- _[🇫🇷 Lire en français](./README.fr.md)_
6
-
7
- ## Highlights
8
-
9
- - Guided launch for first-time users
1
+ # Claude Code for RouterLab
2
+
3
+ `claude-scionos` is a RouterLab launcher for the official Claude Code CLI. It keeps the normal Claude Code workflow, while adding guided onboarding, strategy routing, secure token storage, and a `doctor` command for client support.
4
+
5
+ _[🇫🇷 Lire en français](./README.fr.md)_
6
+
7
+ ## Highlights
8
+
9
+ - Guided launch for first-time users
10
10
  - `--strategy` to preselect a routing strategy
11
+ - `--service llm` for invitation-only RouterLab LLM access
11
12
  - `--no-prompt` for automation and CI
12
13
  - `--list-strategies` to inspect available routes
13
- - `doctor` to diagnose local setup quickly
14
- - `auth login|status|change|logout|test` for secure token management
15
- - Local proxy only when a mapped strategy is selected
16
-
17
- ## Requirements
18
-
19
- - Node.js 22 or later
14
+ - `doctor` to diagnose local setup quickly
15
+ - `auth login|status|change|logout|test` for secure token management
16
+ - Local proxy only when a mapped strategy is selected
17
+
18
+ ## Requirements
19
+
20
+ - Node.js 22 or later
20
21
  - A RouterLab token from [routerlab.ch/keys](https://routerlab.ch/keys)
21
- - On Windows, Git Bash must be installed for Claude Code
22
-
23
- ## Installation
24
-
25
- Run directly with `npx`:
26
-
27
- ```bash
28
- npx claude-scionos
29
- ```
30
-
31
- Or install globally:
32
-
33
- ```bash
34
- npm install -g claude-scionos
35
- claude-scionos
36
- ```
37
-
38
- ## Quick Start
39
-
40
- Guided mode:
41
-
42
- ```bash
43
- npx claude-scionos
44
- ```
45
-
46
- Useful commands:
47
-
48
- ```bash
22
+ - Or an invitation token for `--service llm`
23
+ - On Windows, Git Bash must be installed for Claude Code
24
+
25
+ ## Installation
26
+
27
+ Run directly with `npx`:
28
+
29
+ ```bash
30
+ npx claude-scionos
31
+ ```
32
+
33
+ Or install globally:
34
+
35
+ ```bash
36
+ npm install -g claude-scionos
37
+ claude-scionos
38
+ ```
39
+
40
+ ## Quick Start
41
+
42
+ Guided mode:
43
+
44
+ ```bash
45
+ npx claude-scionos
46
+ ```
47
+
48
+ Useful commands:
49
+
50
+ ```bash
49
51
  npx claude-scionos --list-strategies
50
52
  npx claude-scionos doctor
51
53
  npx claude-scionos auth login
54
+ npx claude-scionos auth login --service llm
52
55
  npx claude-scionos auth test
53
56
  npx claude-scionos --strategy aws
57
+ npx claude-scionos --service llm --strategy claude-glm-5
54
58
  npx claude-scionos --strategy aws --no-prompt -p "Summarize this repo"
55
59
  ```
56
60
 
57
- ## Strategies
61
+ ## Services
62
+
63
+ - Default behavior uses `https://routerlab.ch`
64
+ - `--service llm` switches the launcher to `https://llm.routerlab.ch`
65
+ - `llm` is intended for invitation-only access
66
+ - Tokens stored with `auth login --service llm` are kept separate from the default RouterLab token
67
+ - `llm` currently exposes `claude-glm-5` and `claude-gpt-5.4`
58
68
 
69
+ ## Strategies
70
+
59
71
  - `default`: use Claude Code normally without the local proxy
60
72
  - `aws`: remap Claude model families to RouterLab AWS-backed Claude variants
61
73
  - `claude-glm-5`: force all requests to `claude-glm-5`
62
74
  - `claude-minimax-m2.5`: force all requests to `claude-minimax-m2.5`
63
-
64
- Use `--list-strategies` to see the current labels and live availability when a token is available.
65
-
66
- ## Token Handling
67
-
68
- Token resolution order:
69
-
75
+ - `claude-gpt-5.4`: force all requests to `claude-gpt-5.4`
76
+
77
+ Use `--list-strategies` to see the strategies available for the selected service and their live availability when a token is available.
78
+
79
+ ## Token Handling
80
+
81
+ Token resolution order:
82
+
70
83
  1. `ANTHROPIC_AUTH_TOKEN`
71
84
  2. Secure local storage from `claude-scionos auth login`
72
- 3. Manual prompt in guided mode
73
-
74
- Secure storage backends:
75
-
76
- - Windows: DPAPI-encrypted local file bound to the current user
77
- - macOS: Keychain
78
- - Linux: Secret Service via `secret-tool`
79
-
80
- Manage the token with:
81
-
82
- ```bash
83
- claude-scionos auth login
84
- claude-scionos auth status
85
- claude-scionos auth change
86
- claude-scionos auth logout
87
- claude-scionos auth test
88
- ```
89
-
85
+ 3. Service-specific secure local storage from `claude-scionos auth login --service llm`
86
+ 4. Manual prompt in guided mode
87
+
88
+ Secure storage backends:
89
+
90
+ - Windows: DPAPI-encrypted local file bound to the current user
91
+ - macOS: Keychain
92
+ - Linux: Secret Service via `secret-tool`
93
+
94
+ Manage the token with:
95
+
96
+ ```bash
97
+ claude-scionos auth login
98
+ claude-scionos auth status
99
+ claude-scionos auth change
100
+ claude-scionos auth logout
101
+ claude-scionos auth test
102
+ ```
103
+
90
104
  ## What `--strategy` and `--no-prompt` mean
91
105
 
92
106
  - `--strategy <value>` skips the interactive strategy menu and selects the route directly
107
+ - `--service <value>` switches between RouterLab targets. `routerlab` is the default and `llm` is invitation-only
93
108
  - `--no-prompt` disables every interactive question
94
-
95
- When `--no-prompt` is used, the launcher must already have a token from `ANTHROPIC_AUTH_TOKEN` or secure storage.
96
-
97
- ## Doctor
98
-
99
- `claude-scionos doctor` checks the local setup and prints a support-friendly summary:
100
-
101
- - platform and Node.js
102
- - Claude Code installation
103
- - Git Bash on Windows
104
- - secure storage backend
105
- - stored or environment token presence
106
- - RouterLab token validation when a token is available
107
-
108
- ## Compatibility
109
-
110
- The wrapper forwards regular Claude Code flags and arguments. The local proxy is only started for mapped strategies. `default` launches Claude Code without the proxy layer.
111
-
112
- ## Troubleshooting
113
-
114
- `claude-scionos doctor` should be the first command to run when a client reports an issue.
115
-
116
- Common cases:
117
-
118
- - `Claude Code CLI not found`: install `@anthropic-ai/claude-code`
119
- - `Git Bash is required on Windows`: install Git for Windows
120
- - `ANTHROPIC_AUTH_TOKEN ... is required when using --no-prompt`: set the environment variable or store the token first
121
- - `secret-tool not found`: install a Secret Service client on Linux or rely on the environment variable
122
-
123
- ## Development
124
-
125
- ```bash
126
- npm install
127
- npm test
128
- npm run lint
129
- node index.js
130
- ```
131
-
132
- ## License
133
-
134
- MIT. See [LICENSE](./LICENSE).
109
+
110
+ When `--no-prompt` is used, the launcher must already have a token from `ANTHROPIC_AUTH_TOKEN` or secure storage.
111
+
112
+ ## Doctor
113
+
114
+ `claude-scionos doctor` checks the local setup and prints a support-friendly summary:
115
+
116
+ - platform and Node.js
117
+ - Claude Code installation
118
+ - Git Bash on Windows
119
+ - secure storage backend
120
+ - stored or environment token presence
121
+ - RouterLab token validation when a token is available
122
+
123
+ ## Compatibility
124
+
125
+ The wrapper forwards regular Claude Code flags and arguments. The local proxy is only started for mapped strategies. `default` launches Claude Code without the proxy layer.
126
+
127
+ ## Troubleshooting
128
+
129
+ `claude-scionos doctor` should be the first command to run when a client reports an issue.
130
+
131
+ Common cases:
132
+
133
+ - `Claude Code CLI not found`: install `@anthropic-ai/claude-code`
134
+ - `Git Bash is required on Windows`: install Git for Windows
135
+ - `ANTHROPIC_AUTH_TOKEN ... is required when using --no-prompt`: set the environment variable or store the token first
136
+ - `secret-tool not found`: install a Secret Service client on Linux or rely on the environment variable
137
+
138
+ ## Development
139
+
140
+ ```bash
141
+ npm install
142
+ npm test
143
+ npm run lint
144
+ node index.js
145
+ ```
146
+
147
+ ## License
148
+
149
+ MIT. See [LICENSE](./LICENSE).