Premiers pas

La CLI lomi. est distribuée via npm sous le nom lomi.cli. Elle sert à s’authentifier, générer des projets SDK, tester les webhooks en local, créer des sessions de checkout et des liens de paiement, et installer des règles pour les assistants IA.

Pour qui

La CLI lomi. s’adresse aux développeurs qui intègrent l’API marchande hébergée depuis le terminal, authentification, génération de projets SDK, tests de webhooks et checkouts sandbox.

Elle ne sert pas à exploiter la plateforme interne de lomi., le tableau de bord admin ni l’auto-hébergement du traitement des paiements. Les marchands qui n’utilisent que le tableau de bord web n’ont pas besoin de la CLI.

Les commandes lomi et lomi. fonctionnent toutes les deux après installation.

Installation

npm (recommandé)

Node.js 18+ requis (uniquement pour télécharger le binaire natif à l’installation).

npm install -g lomi.cli

Ou avec pnpm :

pnpm add -g lomi.cli

L’installation npm télécharge le binaire adapté à votre plateforme depuis GitHub Releases.

Homebrew

brew tap lomiafrica/tap
brew install lomi

Depuis les sources

git clone https://github.com/lomiafrica/lomi.
cd lomi./apps/cli
cargo install --path .

Vérifier l’installation

lomi --version
lomi --help

Dépannage de l’installation

Symptôme	Cause probable	Action
`lomi: command not found` après `npm install -g`	binaire npm global absent du `PATH`	`npm prefix -g` puis ajouter le dossier `bin` au `PATH`, ou `npx lomi.cli --version`
Installé mais `lomi --version` échoue (glibc / `GLIBC_X.XX' not found)	Binaire compilé pour une glibc plus récente que votre Linux	Homebrew, release GitHub, ou compilation depuis les sources
OK sur macOS, échec sur une CI Linux ancienne	Images CI avec glibc ancienne	Build source en CI ou image plus récente (glibc ≥ 2.39 pour les binaires npm Linux à ce jour)

npm exige seulement Node.js 18+ pour télécharger le binaire natif ; le CLI ne s’exécute pas sur Node. Si npm install -g lomi.cli réussit mais le binaire ne démarre pas, c’est un problème de compatibilité plateforme, pas de version Node.

Plateformes supportées

Plateforme	Installation
macOS (Apple Silicon)	npm, Homebrew, GitHub Release
macOS (Intel)	npm, Homebrew, GitHub Release
Linux (x64)	npm, Homebrew, GitHub Release
Windows (x64)	Bientôt disponible

Démarrage rapide

Connexion

lomi login

Vérifier le statut

lomi status

Initialiser un projet

cd mon-app
lomi init

Règles agent IA (optionnel)

Installe les règles Cursor, CLAUDE.md, AGENTS.md, instructions VS Code et llms.txt. Voir Installer les règles agent.

Écouter les webhooks (recommandé)

lomi listen http://localhost:3000/webhooks

Reçoit de vrais webhooks sandbox via relais cloud, sans ngrok. Voir Écouter les webhooks.

Lancer le serveur webhook local

lomi dev

Démarre un récepteur webhook sur http://localhost:4242/webhook. Voir Serveur de développement local.

Aperçu des commandes

Commande	Description
`lomi login`	Authentification navigateur
`lomi logout`	Supprimer les identifiants d’un profil
`lomi whoami`	Profil actif
`lomi status`	Connexion et API
`lomi init`	Générer les fichiers SDK
`lomi quickstart`	Parcours rapide et prochaines étapes
`lomi listen`	Relais webhook cloud (sandbox)
`lomi dev`	Serveur webhook local
`lomi probe`	Vérifications d'intégration
`lomi checkout create`	Créer une session checkout
`lomi payments create`	Créer un lien de paiement
`lomi transactions list` / `get`	Lister ou récupérer une transaction
`lomi refunds create` / `list` / `get`	Remboursements
`lomi install-rules`	Documentation pour assistants IA
`lomi update`	Mettre à jour `@lomi./sdk`
`lomi list-profiles`	Lister les profils
`lomi switch`	Changer de profil

Référence complète : Commandes.

Options globales

Option	Description
`--profile <nom>`	Profil à utiliser (défaut : `default`)
`-a, --api-url <url>`	URL de base de l’API
`-l, --log-level <niveau>`	`debug`, `info`, `warn`, `error`
`--skip-telemetry`	Désactiver la télémétrie
`--json`	Sortie JSON (par défaut si stdout n’est pas un TTY)
`-h, --help`	Aide pour la CLI ou une sous-commande
`--version`	Afficher la version

Deux types d’identifiants

Jeton CLI vs clé API

lomi login enregistre un jeton CLI global, utilisé par les commandes CLI.

lomi init écrit la clé API secrète (LOMI_SECRET_KEY) dans le .env du projet, utilisée par le SDK dans votre code applicatif.

Suite

Authentification : flux device, profils, CI
Initialiser un projet : scaffolding SDK
Référence des commandes : toutes les commandes et options
Configuration : chemins de config et variables d’environnement
Intégration API : guide HTTP et SDK

Premiers pas

Sur cette page