Premiers pas avec Augure Code
L'agent de codage dans votre terminal. Une ligne pour l'installer, votre compte Augure ou une clé API pour vous connecter — et il lit votre dépôt, modifie des fichiers, exécute des commandes et répare ce qui casse.
1. Installation
Une seule ligne sur macOS ou Linux. L'installateur télécharge la version adaptée à votre plateforme, vérifie sa somme de contrôle et place augure sur votre PATH.
curl -fsSL https://augureai.ca/install.sh | shPlateformes : macOS 12+ (Apple Silicon et Intel) et Linux x64/arm64 (glibc 2.34+ — Ubuntu 22.04+, Debian 12+, RHEL 9+, Fedora 35+). Sous Windows, installez-le dans WSL2.
Ce qui est modifié : le binaire va dans ~/.local/bin (ou /usr/local/bin) et une configuration par défaut dans ~/.codex/config.toml. Une configuration existante n'est jamais écrasée.
2. Connectez votre compte
L'installateur vous demande comment vous connecter, et augure offre les mêmes choix au premier lancement. Deux chemins possibles — prenez celui qui vous convient.
Option A — Connexion avec votre compte Augure
Idéal pour le travail interactif. Fonctionne avec les forfaits Gratuit, Pro et Max — les forfaits Pro et Max incluent le calcul d'Augure Code dans l'allocation mensuelle, sans rien d'autre à configurer.
augure loginVotre navigateur s'ouvre sur chat.augureai.ca. Connectez-vous avec Google, Microsoft ou votre courriel — l'onglet affiche ensuite « Signed in to Augure » et votre terminal confirme avec votre courriel. Les identifiants vivent dans ~/.codex/augure-auth.json, rafraîchis automatiquement; augure logout les supprime.
Déjà connecté sur le site? On vous demandera quand même de vous connecter — c'est voulu. Le terminal reçoit sa propre session privée, remise directement et jamais conservée dans le navigateur : vous déconnecter du site plus tard ne cassera pas votre CLI.
Option B — Avec une clé API
Idéal pour la CI, l'automatisation et les gros travaux d'agent : facturation à l'usage en dollars canadiens, sans limites de forfait. Créez une clé dans le portail développeurs (accès instantané; un mode de paiement est requis avant votre première clé). La clé n'est affichée qu'une seule fois — copiez-la tout de suite.
# collez-la quand l'installateur ou le premier lancement la demande, ou :
export AUGURE_API_KEY=<votre clé>Vous pouvez détenir jusqu'à 5 clés actives, et les régénérer ou les révoquer dans le portail. Un plafond de sécurité de 500 $ CA par jour s'applique à l'ensemble de votre compte.
Note de confidentialité : le trafic des modèles va vers un seul hôte — api.augureai.ca — avec zéro rétention de données. La connexion au compte et le rafraîchissement des jetons passent aussi par le service d'authentification d'Augure, hébergé au Canada, et le CLI vérifie au plus une fois par jour le serveur de versions d'Augure (désactivez avec check_for_update_on_startup = false). Tous les hôtes sont les nôtres — jamais de tiers.
3. Votre première session
Lancez augure dans n'importe quel dépôt et écrivez ce que vous voulez — « explique-moi ce code », « répare le test qui échoue », « ajoute une option --verbose ». En français ou en anglais. L'agent explore, propose des changements et demande avant d'exécuter quoi que ce soit hors de son bac à sable.
/model change de modèle. Rosedale One, notre meilleur modèle de codage, demande un forfait Pro ou Max (ou une clé API).
Forfait gratuit? Si un modèle n'est pas inclus dans votre forfait, Augure Code en choisit un disponible au démarrage et vous le dit — commencez gratuitement, passez au niveau supérieur quand vous êtes prêt.
AUGURE.md à la racine de votre dépôt donne à l'agent des consignes permanentes pour ce projet.
Mode autonome et CI
augure exec exécute une tâche sans interface et ne pose jamais de question — configurez l'authentification d'abord. Une clé API en variable d'environnement est l'outil qu'il faut ici.
export AUGURE_API_KEY=<votre clé>
augure exec "lance la suite de tests et résume les échecs"
# installation non interactive (aucune question) :
curl -fsSL https://augureai.ca/install.sh | AUGURE_NON_INTERACTIVE=1 shDépannage
« Missing environment variable: AUGURE_API_KEY »
Aucun identifiant n'est configuré. Lancez augure login pour utiliser votre compte Augure, ou exportez votre clé. (Les versions antérieures à 1.0.2 ne mentionnent pas augure login dans ce message — la commande y fonctionne quand même.)
« … requires a Pro plan » (HTTP 429)
Le modèle choisi n'est pas inclus dans votre forfait. Changez-en avec /model, ou passez à un forfait supérieur sur chat.augureai.ca/pricing. Les autres 429 sont des limites d'usage quotidiennes ou mensuelles — le message précise laquelle, et quand elle se réinitialise.
« API access is paused » (HTTP 402)
Votre mode de paiement a expiré. Mettez-le à jour dans le portail développeurs et les requêtes reprennent immédiatement.
Mise à jour
À partir de la 1.0.2, Augure Code affiche un avis quand une nouvelle version paraît — lancez augure update pour l'installer (somme de contrôle vérifiée; configuration et identifiants intacts). Relancer l'installateur fonctionne aussi, et c'est la façon de mettre à jour depuis la 1.0.0 ou la 1.0.1.
Où tout se trouve
Configuration : ~/.codex/config.toml · Identifiants du compte : ~/.codex/augure-auth.json (supprimés par augure logout) · Binaire : ~/.local/bin/augure ou /usr/local/bin/augure.
Prêt à coder?
Une ligne pour l'installer. Connectez votre forfait, ou optez pour la facturation à l'usage avec une clé API.