saisir · CLI

Monte un agent réel sur ta machine, guidé pas à pas par saisir.ai.

Le CLI prolonge le mode sandbox de l'app sur ton terminal : il déroule une recette étape par étape (le pourquoi, les commandes, le code à coller), tu fais le travail, et après chaque étape il vérifie tes fichiers sur disque.

$ npx saisir-cli              # ouvre la session interactive
saisir › /login              → URL à cliquer, autorise dans le navigateur
saisir › /cook sav
  ● Étape 3/11 · Pose ta clé dans l'env
    $ ... (tu lances, le CLI vérifie)
  ✓ .env trouvé · ANTHROPIC_API_KEY présent
saisir › /quit

Commandes

Lance saisir (sans argument, dans un terminal) pour ouvrir une session interactive :

• /cook <recette> · construis l'agent pas à pas (pilote : sav). Tab complète les noms de recette.
• /recipes · liste les recettes.
• /login · connecte ton compte saisir.ai via une URL à cliquer (device-grant).
• /whoami · /logout · /clear · /help · /quit.

Chaque commande marche aussi en one-shot (scripting) : saisir cook sav, saisir login, saisir whoami… (build reste un alias de cook.)

Le CLI ne touche jamais de modèle

Le CLI rejoue la recette de façon déterministe et ne fait aucun appel à un LLM. L'agent que tu construis, lui, tourne en vrai sur ta clé (ANTHROPIC_API_KEY) quand tu le lances (npx tsx agent.ts). Le CLI ne lit ni ne stocke ta clé Anthropic : il te guide juste pour la poser dans le .env de ton projet. C'est la ligne du replay-only : l'app distribuée ne fait jamais d'appel live, ton terminal avec ta clé oui.

Configuration

• SAISIR_ANON_KEY (optionnel) · surcharge la clé anon publique embarquée par défaut (role anon, publishable · RLS protège la donnée). Inutile en usage normal.
• SAISIR_API_BASE (optionnel) · base des routes API (défaut https://www.saisir.ai/api).
• SAISIR_SUPABASE_URL (optionnel) · défaut https://avtazwdhqhguqpsfxtti.supabase.co.

La session est stockée dans ~/.saisir/session (chmod 600).

Dév

npm install
npm run sync-recipes   # embarque le fallback depuis mobile/assets/sandbox
npm run build          # tsc → dist/
npm test               # canonical + verify + shell (parseLine/completer)
npm run dev -- whoami  # exécute en TS sans build