samubrn22/pennylane-cli

pennylane-cli

CLI pour l'API publique Pennylane v2. Factures, clients, devis, encaissements, balance comptable, en ligne de commande.

Conçu pour être piloté aussi bien à la main que par un agent (Claude Code, Codex, ou tout autre) : sortie JSON par défaut, erreurs exploitables, et une commande pnl spec qui décrit tout l'outil en un appel.

Lecture seule. Aucune commande n'écrit dans votre comptabilité.

Pourquoi

L'API Pennylane v2 ne filtre que sur une poignée de champs. Des critères aussi courants que status ou paid existent dans la réponse mais renvoient un HTTP 400 si on les demande au serveur, et rien ne compte les résultats côté serveur : sans pagination complète, un total est faux sans le signaler.

Ce CLI absorbe ces contraintes. Il accepte les critères que l'API refuse, parcourt la pagination quand il le faut, avertit dès qu'une liste est coupée, et refuse localement les filtres invalides avec la liste de ce qui est accepté.

Prérequis

• Python 3.11 ou plus
• uv (recommandé) ou pip
• Un compte Pennylane avec le rôle administrateur et un abonnement Essentiel ou supérieur, nécessaire pour générer un token

Installation

uv tool install git+https://github.com/Kokoro-agency/pennylane-cli

Avec pip :

pip install git+https://github.com/Kokoro-agency/pennylane-cli

Depuis une copie locale, en mode éditable :

git clone https://github.com/Kokoro-agency/pennylane-cli
cd pennylane-cli
uv tool install --editable .

Obtenir un token API

Dans Pennylane : roue crantée en haut à droite → Connectivité → Développeurs → Générer un token d'API.

Deux choix comptent :