Démarrer avec capsul : installer, lancer, mesurer

1. Installer

$npm i -g @penra/capsul

2. Vérifier l'environnement

doctor indique quels CLI d'agent il détecte, quelles identifications sont configurées, et où les choses sont rangées. Il montre où elles vivent sans jamais montrer ce qu'elles sont.

$capsul doctor

Si votre CLI d'agent n'est pas détecté ici, rien d'autre ne marchera. Réglez cette étape avant d'aller plus loin.

3. Construire un contexte sans rien dépenser

C'est la commande à lancer en premier, sur une tâche que vous avez vraiment. Elle assemble le contexte et annonce ce qu'il coûte, sans appeler de modèle et sans toucher à votre quota.

$capsul context 'pourquoi la redirection de connexion boucle'

Ajoutez --json pour une sortie machine, et --open quand vous savez déjà quel fichier compte :

$capsul context 'répare la boucle de redirection' --open src/middleware.ts --json

4. Lancer la tâche

ask fait le même assemblage puis confie la requête au CLI d'agent auquel vous êtes connecté. C'est votre abonnement Claude ou ChatGPT existant qui répond : aucune clé API à coller, aucune seconde facture de modèle.

$capsul ask 'répare la boucle de redirection' --budget 3000

Lancer capsul sans sous-commande ouvre une session interactive, où l'on choisit l'agent et où l'on discute.

$capsul

Ensuite

• →capsul stats cumule les tokens économisés au fil du temps. Le registre est un simple fichier sur votre disque.
• →capsul burn détaille la dépense locale par agent, par modèle et par projet.
• →--model haiku pour le travail mécanique : renommages, mise en forme, édition d'un seul fichier.
• →--budget <n> pose un plafond dur sur le contexte. Rien ne déborde en silence.