Démarrer avec tom

Installer tom

Sur macOS ou Linux :

curl -fsSL https://tokens-on.me/install.sh | sh

Ou avec Homebrew :

brew install mindsersit/tap/tokens-on-me

Sous Windows, dans PowerShell :

irm https://tokens-on.me/install.ps1 | iex

Elle vérifie le téléchargement avec les sommes de contrôle de la version, puis place tom dans ~/.local/bin, ou dans votre dossier utilisateur sous Windows. Elle n’installe rien d’autre et n’a pas besoin de Node. Sous Windows, elle ajoute aussi ce dossier à votre Path ; sur macOS et Linux, elle indique quoi ajouter si ce dossier n’y est pas.

Lancer votre outil de code

Installez votre outil de code en suivant ses instructions officielles, puis lancez tom suivi de son nom :

tom claude

Claude Code

tom codex

Codex

tom omp

oh-my-pi

tom gemini

Gemini CLI

La première fois, tom ouvre votre navigateur pour connecter cet ordinateur : sélectionnez Autoriser si vous venez de lancer tom. L’ordinateur apparaît ensuite dans Compte, où vous pouvez le déconnecter.

Sur un ordinateur sans navigateur, comme un serveur, lancez tom login --code : il affiche une adresse et un code à saisir sur un autre appareil.

Tout ce qui suit le nom de l’outil lui est transmis :

tom claude -p "fix the failing test"

Si vous avez plusieurs budgets

Si plusieurs de vos budgets conviennent à un outil, tom demande lequel utiliser à chaque lancement : choisissez avec les flèches ou son numéro, puis Entrée. Pour ne plus avoir à répondre, choisissez-en un avec tom use. Pour un seul lancement, utilisez --allowance :

tom use workshop
tom claude --allowance=workshop

Lancez tom seul pour voir vos budgets, ce qu’il reste sur chacun et la commande qui lance chaque outil. Un nom peut être abrégé s’il reste unique.

Rôle de chaque commande

tom

Qui est connecté, vos budgets et comment lancer chaque outil.

tom list

Vos budgets : qui les a attribués, ce qu’il reste, jusqu’à quand et avec quels modèles.

tom use <name>

Choisit le budget utilisé pour les outils que ses modèles permettent, jusqu’au prochain choix.

tom login

Connecte cet ordinateur depuis votre navigateur. Avec --code, sans navigateur.

tom logout

Déconnecte cet ordinateur : ses jetons cessent immédiatement de fonctionner.

tom update

Installe la dernière version de tom.

tom --help

Affiche ces commandes.

Données envoyées par tom

tom communique uniquement avec Tokens On Me, pour connecter cet ordinateur et lancer votre outil, et avec GitHub, pour se mettre à jour. Il n’envoie ni télémétrie, ni rien sur vos projets, fichiers, prompts ou réponses. Votre outil de code envoie vos prompts à Tokens On Me comme il le ferait sans tom ; nous ne les stockons pas.

La connexion de cet ordinateur est enregistrée dans ~/.config/tokens-on-me/, lisible par vous seul. Un ordinateur inutilisé pendant 90 jours est déconnecté automatiquement.

Mettre tom à jour

tom update installe la dernière version après avoir vérifié sa signature avec la clé intégrée à votre version actuelle :

tom update

Si vous l’avez installé avec Homebrew, mettez-le à jour avec Homebrew :

brew upgrade tokens-on-me

Vérifier un téléchargement

Chaque version sur GitHub est publiée avec ses sommes de contrôle (SHA256SUMS) et leur signature (SHA256SUMS.minisig). Téléchargez ces deux fichiers et votre archive dans un même dossier, puis vérifiez-les avec minisign :

minisign -Vm SHA256SUMS -P RWQjQZP+j4ZFXuFpARpr1WbmE8rA+ih5jbmLvwT/c6apfMxOSf6sdjGo
shasum -a 256 -c SHA256SUMS --ignore-missing

La première commande vérifie que les sommes de contrôle viennent de nous, la seconde que votre archive leur correspond. Sous Windows, comparez le résultat de Get-FileHash avec la ligne de votre archive dans SHA256SUMS.

Désinstaller tom

Déconnectez d’abord cet ordinateur : sa connexion cesse aussitôt.

tom logout

Supprimez ensuite tom et son dossier : ~/.local/bin/tom et ~/.config/tokens-on-me/ sur macOS et Linux, .local\bin\tom.exe et .config\tokens-on-me dans votre dossier utilisateur sous Windows. Avec Homebrew : brew uninstall tokens-on-me, puis supprimez le dossier. Sous Windows, retirez aussi .local\bin de votre Path s’il ne sert plus.

Ou configurer à la main

Le guide de chaque outil donne aussi les commandes à utiliser avec votre jeton : Claude Code, Codex, Gemini CLI et oh-my-pi. Une extension d’éditeur ou une application de bureau en a besoin : tom ne lance que l’outil en ligne de commande.