Passer au contenu principal
La Hyperline CLI vous permet de gérer vos opérations de facturation directement depuis le terminal. Elle est conçue pour être agent-first — optimisée pour les agents IA tels que Claude Code, Cursor, Windsurf et tout outil capable d’exécuter des commandes shell.

​
Pourquoi une CLI pour les agents IA ?

Les agents IA s’appuient sur des outils pour accomplir leurs tâches. Aujourd’hui, la plupart des agents utilisent MCP (Model Context Protocol) pour se connecter à des services externes. Bien que MCP fonctionne bien, il présente des limites lorsqu’il est utilisé à grande échelle :
  • Surcharge du contexte — Les serveurs MCP exposent des dizaines d’outils, chacun avec des schémas complets qui consomment un espace précieux dans la fenêtre de contexte.
  • Plus lent sur les tâches complexes — Pour les workflows multi-étapes, les agents utilisant MCP doivent découvrir des outils, lire des schémas et formater des requêtes structurées pour chaque opération. Sur des questions complexes, les agents MCP peuvent boucler pendant plusieurs minutes en tentant de trouver la bonne combinaison d’outils.
Les CLI résolvent ces problèmes :
  • Efficaces en jetons — Des commandes courtes comme hyperline customers list sont naturelles à écrire pour un modèle prédictif de texte et nécessitent très peu de contexte pour être comprises.
  • Pas de surcoût de découverte d’outils — Les agents n’ont pas besoin de charger un catalogue d’outils ni de lire des schémas JSON. Ils exécutent simplement des commandes et lisent la sortie.
  • Composables — La sortie de la CLI peut être redirigée, filtrée avec jq ou chaînée avec d’autres commandes — des schémas que les agents gèrent nativement.

​
Installation

npm install -g @hyperline/cli
Vérifiez l’installation : 
hyperline --version

​
Authentification

​
Connexion via navigateur

La méthode la plus simple pour s’authentifier — ouvre votre navigateur pour vous connecter en toute sécurité avec votre compte Hyperline : 
hyperline login
Les identifiants sont stockés localement dans ~/.hyperline/. Pour vous déconnecter : 
hyperline logout

​
Clé API

Pour les environnements serveur, les pipelines CI/CD ou les agents IA fonctionnant sans navigateur : 
# Via une variable d'environnement
export HYPERLINE_API_KEY=sk_test_...

# Ou en ligne
hyperline customers list --api-key sk_test_...
Les clés API peuvent être générées depuis les Paramètres de votre compte.
Gardez votre clé API secrète. Ne la commitez pas dans un système de gestion de versions — utilisez plutôt des variables d’environnement ou un gestionnaire de secrets.
Pour les environnements sandbox, définissez l’URL de base via une variable d’environnement ou un flag :
export HYPERLINE_API_URL=https://api.sandbox.hyperline.co

# Ou par commande
hyperline customers list --base-url https://api.sandbox.hyperline.co

​
Sélection de l’entreprise

Si vous avez accès à plusieurs entreprises, la CLI utilise par défaut la dernière entreprise utilisée. Pour basculer vers une entreprise spécifique : 
hyperline company select

​
Utilisation

La CLI suit un schéma cohérent hyperline <resource> <action> : 
# Lister les clients
hyperline customers list

# Récupérer une facture spécifique
hyperline invoices get --id inv_xxxxx

# Créer un nouveau client
hyperline customers create --name "Acme Inc" --currency USD

​
Ressources disponibles

RessourceDescription
customersCréer, mettre à jour, lister et gérer votre base de clients
subscriptionsGérer le cycle de vie des abonnements, les annulations et les modèles
invoicesCréer, lister et gérer les factures et transactions
productsDéfinir et mettre à jour votre catalogue produits
quotesGénérer et gérer les devis
walletsGestion des portefeuilles prépayés et recharges
couponsCréer des coupons de remise et des codes promotionnels
webhooksConfigurer les endpoints webhook
paymentsSuivre et gérer les paiements
analyticsAccéder aux métriques de facturation
exportsExporter vos données de facturation
custom-propertiesÉtendre les ressources avec des champs personnalisés
taxesConsulter les taux de taxe et configurations
invoicing-entitiesGérer vos entités de facturation
Utilisez --help sur n’importe quelle commande pour voir les actions et options disponibles : 
hyperline customers --help
hyperline invoices list --help

​
Formats de sortie

Par défaut, la CLI produit du texte lisible par un humain. Utilisez --output json pour une sortie structurée : 
# Sortie lisible
hyperline customers list

# Sortie JSON pour les scripts
hyperline customers list --output json

# Redirection vers d'autres outils
hyperline customers list --output json | jq '.[].name'

​
Options globales

OptionDescription
--api-key <key>Clé API (remplace HYPERLINE_API_KEY)
--base-url <url>URL de base de l’API (remplace HYPERLINE_API_URL)
--output <format>json ou text (par défaut : text)
--helpAfficher l’aide
--versionAfficher la version

​
Configuration pour les agents IA

​
Claude Code

Ajoutez la Hyperline CLI au CLAUDE.md de votre projet pour que Claude sache qu’elle est disponible : 
## Tools

Hyperline CLI is available for billing operations.
Authenticate with: `export HYPERLINE_API_KEY=sk_...`
Usage: `hyperline <resource> <action> [options]`
Use `--output json` when you need to process the data.

​
Cursor / Windsurf

Ajoutez des instructions à vos règles de projet (.cursor/rules/ ou .windsurfrules) pour que l’agent sache utiliser la CLI : 
## Billing

Use the Hyperline CLI for any billing-related tasks.
Run `hyperline <resource> <action>` commands in the terminal.
Use `--output json | jq` for filtering and processing data.

​
Tout agent ayant accès au shell

Tout agent IA capable d’exécuter des commandes shell peut utiliser la Hyperline CLI. Définissez la variable d’environnement HYPERLINE_API_KEY dans l’environnement de l’agent et la CLI est prête à l’emploi — aucune configuration supplémentaire ni enregistrement d’outil n’est nécessaire.

​
CLI vs MCP — lequel utiliser ?

CLIMCP
Idéal pourAgents IA avec accès shell, scripts, automatisationAssistants IA sans accès terminal (Claude.ai, ChatGPT)
Mise en placenpm install -g @hyperline/cliAjouter l’URL du serveur MCP à votre client
AuthentificationClé API ou connexion via navigateurOAuth ou clé API
Coût en contexteMinimal — uniquement des chaînes de commandePlus élevé — schémas d’outils complets chargés dans le contexte
Tâches multi-étapesExcellent — redirection, chaînage et composition de commandesPeut peiner avec les workflows complexes
Fonctionne avecClaude Code, Cursor, Windsurf, tout agent basé sur le terminalClaude.ai, ChatGPT, tout client compatible MCP
Vous pouvez utiliser les deux. Le serveur MCP est idéal pour les assistants IA conversationnels, tandis que la CLI brille pour les agents qui travaillent dans le terminal.

Serveur Hyperline MCP

Découvrez comment configurer le serveur Hyperline MCP pour les assistants IA sans accès au terminal.