Code v6 Augmented

Produit CLI de coding OAL SARL, propulse par Pollinations AI (kimi, mistral, gemini-fast).

Proprietary Product Notice

Code est un produit proprietaire de OAL SARL.

• Licence du produit: voir LICENSE.md
• Notice produit: voir NOTICE.md
• Marques et branding: voir TRADEMARKS.md

Prerequis

• Node.js >= 20
• Bun >= 1.0
• Git
• Shell local disponible
  • Windows: PowerShell 5+ ou PowerShell 7+
  • macOS / Linux: bash ou sh
  • Git Bash sur Windows reste supporte, mais n'est plus obligatoire

Installation

npm install
npm run typecheck
npm test
npm run build

Installation globale:

npm pack
npm install -g ./oal-sarl-code-6.0.0.tgz

Si oal-code n'est pas reconnu sous PowerShell:

$env:Path += ";$env:APPDATA\npm"

Configuration API

Obtiens une cle sur https://enter.pollinations.ai puis:

oal-code config --key pk_xxx

Options:

oal-code config --model mistral
oal-code config --language fr
oal-code config --no-memory
oal-code config --no-web-search
oal-code config --no-undo

Usage

Mode interactif:

oal-code chat

Publication npm publique:

npm login
npm publish --access public

Package npm cible:

@oal-sarl/code

Repository npm/publication cible:

https://github.com/oal-sarl/code

Statut de diffusion:

• package public npm
• code source interne non expose via src/
• artefact distribue via bundle dist/

Mode one-shot (CI/script):

oal-code run "Analyse ce projet et propose un plan."

Slash Commands v6

• /plan <task>
• /fix <error>
• /test <file>
• /review
• /refactor <file>
• /model <kimi|mistral|gemini-fast>
• /git <action>
• /file <path> (PDF/image/csv/json/txt)
• /img <path> (alias)
• /screenshot [url]
• /preview [url]
• /history
• /share
• /skill [name]
• /render <remotion|manim>
• /agents t1 | t2 | t3
• /session <new|list|switch|close>
• /sandbox <safe|docker|none>
• /undo
• /memory
• /env
• /clear
• /clear --memory
• /help

Capacites v6

• Multi-session interactive (creation/switch/close, sessions paralleles).
• Historique JSONL par projet/session (~/.code/history/...).
• Vision fichiers (/file, /img) avec PDF/CSV/image.
• Screenshot Playwright (/screenshot) + analyse visuelle.
• Preview server local (/preview) avec auto-reload.
• Skills built-in + user skills (src/skills, ~/.code/skills).
• Sandbox shell (safe, docker, none) avec fallback robuste.
• Transactions atomiques avec rollback et preview.
• Edition AST TypeScript avec fallback propre.
• Judge hybride et verification outillee avant reponse finale.
• Tool verification policy + parser dual <n>/<name>.
• Compaction contexte abortable + fallback local anti-blocage.

Tool Verification Policy

Code impose une regle de verification:

• Toute affirmation factuelle sur le codebase (fichiers, symboles, architecture, etat git) doit etre basee sur au moins un appel outil (read_file, search_code, list_dir, git_*, bash).
• Si aucune preuve outil n'est collectee, Code force un appel d'outil avant la reponse finale.

Debug et Monitoring

Activer les logs:

CODE_DEBUG=1 oal-code chat

Logs exposes:

• tool calls parses,
• execution parallele,
• ledger de preuves outils,
• raisons de compaction fallback,
• healing attempts.
• metrics de fiabilite (iterations, toolCalls, toolErrors, retries, interruptions) en mode debug.

Benchmarks publics

Benchmark fiabilite v1:

npm run bench

Sorties:

• bench/results/latest.json
• bench/results/latest.md

Variables utiles:

• CODE_BENCH_TIMEOUT_MS (defaut: 180000)
• CODE_BENCH_RETRIES (defaut: 1)
• CODE_BENCH_SCENARIO_LIMIT (defaut: 0, tous les scenarios)

SWE-lite (pass@1)

Mesure proxy de type SWE (non officielle SWE-bench), avec verifications attendues scenario par scenario:

npm run swe:lite

Sorties:

• bench/results/swe-lite-latest.json
• bench/results/swe-lite-latest.md

Variables utiles:

• CODE_SWE_LITE_TIMEOUT_MS (defaut: 120000)
• CODE_SWE_LITE_MODEL (defaut: mistral)

Troubleshooting

Windows UTF-8 / glyphes

• Code supporte fallback ASCII via src/ui/glyphs.ts.
• Si besoin, force ASCII:

$env:CODE_GLYPHS = "ascii"

Shell introuvable

Code choisit automatiquement un shell selon l'OS:

• Windows: Git Bash si present, sinon pwsh, puis powershell, puis cmd
• macOS / Linux: bash, puis sh

Tu peux forcer un shell avec:

$env:CODE_SHELL_PATH = "C:\Program Files\PowerShell\7\pwsh.exe"

Compatibilite historique Git Bash:

$env:CODE_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"

Erreurs API Pollinations

• 401: cle invalide.
• 402: solde insuffisant.
• 429: rate-limit (retry/backoff auto).
• 503: indisponibilite temporaire (retry auto).

TTY / session interactive

• oal-code chat requiert un terminal TTY.
• En CI, utilise oal-code run "..."

Release v6

Verification release locale:

npm test
npm run build
npm pack

Verification du tarball:

npm install -g ./oal-sarl-code-6.0.0.tgz
oal-code --version
oal-code run "Lis package.json et donne-moi le nom du projet."

Distribution multi-plateforme

Code est aujourd'hui distribue comme CLI Node.js cross-platform, pas comme binaire natif autonome.

Plateformes cibles:

• Windows 10/11 avec PowerShell ou Git Bash
• macOS avec bash ou sh
• Linux avec bash ou sh

Points de verification avant publication:

• npm test
• npm run build
• npm pack
• test local Windows
• test local macOS
• test local Linux

Commande de smoke test recommandee sur chaque OS:

oal-code --version
oal-code run "Lis package.json et donne-moi le nom du projet."
oal-code chat --setup