Documentation

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.

Terminal
curl -fsSL https://augureai.ca/install.sh | sh

Plateformes : 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 tous les forfaits, y compris le forfait gratuit — les forfaits payants incluent le calcul d'Augure Code dans l'allocation mensuelle, sans rien d'autre à configurer.

Terminal
augure login

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

Terminal
# 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.

Exemple CI
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 sh

Utiliser un autre outil de code

Vous préférez OpenCode, Cline, Aider, Continue ou Zed? Avec Max et Ultra, vous les branchez sur votre propre forfait au moyen d'un jeton CLI. L'utilisation est décomptée de l'abonnement que vous payez déjà : aucune clé d'API, aucune deuxième facture, aucune carte à fournir.

Créez-en un sous Paramètres → Connecter un outil de code. Le jeton n'est affiché qu'une fois, expire après 90 jours par défaut et se révoque quand vous le voulez : un par appareil, en général.

~/.config/opencode/opencode.json (ou opencode.jsonc)
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "augure": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Augure",
      "options": {
        "baseURL": "https://api.augureai.ca/v1",
        "apiKey": "{env:AUGURE_TOKEN}"
      },
      "models": {
        "ossington-5": { "name": "Ossington 5" },
        "tofino-3": { "name": "Tofino 3" },
        "rosedale-1": { "name": "Rosedale One" }
      }
    }
  }
}

Le fichier compte autant que son contenu : OpenCode lit ~/.config/opencode/opencode.json (ou opencode.jsonc) pour la configuration globale, ou un opencode.json à la racine du projet. Vous connecter sans ce bloc vous laisse un jeton sans fournisseur : le sélecteur de modèles reste vide, ce qui donne l'impression que le jeton ne fonctionne pas.

Ensuite, soit export AUGURE_TOKEN=aug_cli_…, soit vous rangez le jeton dans le trousseau d'OpenCode et vous retirez la ligne apiKey :

Ranger le jeton plutôt que l'exporter
opencode auth login
#   → choisissez « Other »
#   → identifiant du fournisseur :  augure   ← l'identifiant, PAS le jeton
#   → collez votre jeton aug_cli_… quand la clé est demandée

opencode models | grep augure   # augure/ossington-5, augure/tofino-3, …
opencode run --model augure/tofino-3 "dis bonjour"

Tout ce qui parle l'API OpenAI fonctionne pareil : l'URL de base ci-dessus, le jeton en guise de clé d'API.

Dé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.

Découvrir Augure CodeObtenir une clé API