Référence des commandes CLI

Le CLI ktm regroupe les commandes par ressource. Il expose 149 commandes réparties en 28 groupes de premier niveau. Choisissez un groupe ci-dessous ou utilisez la barre latérale.

Flags globaux

Ces flags s'appliquent à toutes les commandes :

Flag	Type	Défaut	Description
`--api-key-file`	string		Chemin vers le fichier contenant la clé API (alternative à la variable d'environnement KAPPTIVATE_API_KEY)
`-d, --debug`	boolean		Active la sortie de débogage : requêtes HTTP, timing et erreurs détaillées sur stderr
`--host`	string		Hôte API (env : KAPPTIVATE_HOST, défaut : app.kapptivate.com)
`--no-color`	boolean		Désactive la sortie colorée (aussi : variable NO_COLOR, TERM=dumb)
`--no-proxy`	boolean		Désactive le proxy HTTP de l'environnement
`-o, --output`	string	`json`	Format de sortie : json, table ou plain (TSV)
`-q, --quiet`	boolean		Supprime les lignes de log de niveau info sur stderr, affiche uniquement les erreurs
`--skip-tls`	boolean		Ignore la vérification des certificats TLS (non sécurisé)

Commandes

adb

ADB : utilisez les téléphones distants comme s'ils étaient branchés sur votre machine

agents

Agents : santé de l'infrastructure, capacité et contrôle des fonctionnalités à l'exécution

alerts

Définitions d'alertes : règles persistantes qui déclenchent automatiquement des incidents sur la plateforme

artifacts

Artifacts : récupérer des captures d'écran, enregistrements et autres artefacts de test

Exécution de tests CI/CD : exécuter des tests depuis des fichiers de configuration JSON et rapporter les résultats

collections

Collections : arborescence hiérarchique de tests et dashboards

dashboards

Dashboards : tableaux de bord analytiques au niveau opérateur avec des widgets de métriques

executions

Executions : résultats d'exécution de campagnes avec données de réussite/échec par test

incidents

Incidents : alertes déclenchées sur la plateforme (OPEN, CLOSED, MANUALLY_CLOSED)

init

Initialiser un espace de travail de création de tests prêt pour les agents (skills, configuration MCP, structure du catalogue)

S'authentifier auprès de Kapptivate via OAuth 2.1 + PKCE

logout

Effacer le token OAuth stocké (et le révoquer côté serveur)

metrics

Metrics : interroger les KPI des monitors, les données des collecteurs passifs et l'utilisation des appareils depuis InfluxDB

monitoring-results

Résultats de monitoring : résultats d'exécution des monitors planifiés

monitors

Monitors : exécutions récurrentes planifiées de tests avec suivi de statut

operators

Operators : entités organisationnelles de premier niveau qui possèdent les produits, tests et utilisateurs

products

Products : applications ou services sous un opérateur contenant des tests et monitors

resources

Resources : SIM, agents web et smartphones disponibles pour l'exécution de tests

reusables

Reusables : fragments de tests partagés (tests avec kind=2) intégrés via des actions d'import

shell

Shell : sessions interactives en direct sur des cartes SIM et agents web

status

Vérifier la connectivité, l'authentification et la version du CLI

test-campaigns

Campagnes de tests : lots ordonnés de tests nommés

tests

Tests : scénarios de test automatisés pouvant être exécutés et surveillés

update

Mettre à jour ktm vers la dernière version (ou une version spécifique)

use

Afficher ou changer le produit par défaut de l'espace de travail (.ktm.json)

users

Users : utilisateurs humains et comptes de service ayant accès à la plateforme

variables

Variables, groupes et variants : configuration au niveau du produit

whoami

Afficher l'identité avec laquelle le CLI s'authentifie (clé API ou token OAuth stocké)

Et ensuite ?

Premiers pas

Installez le CLI et authentifiez-vous.

CI/CD

Exécutez des tests depuis votre pipeline.