Failproof Cloud CLI

Utilisez fp pour inspecter la télémétrie Cloud, gérer l’application gérée depuis le cloud (politiques, déploiements de flotte, décisions de garde-fous), ainsi que les audits, résultats, problèmes, alertes, clés, utilisateurs, requêtes et paramètres. Utilisez failproofai pour les hooks locaux, les politiques, la capture et l’enrôlement des machines. Installez la Cloud CLI publiée comme outil isolé :

uv tool install fp-cloud-cli
fp version

Se connecter

fp login
fp whoami

Syntaxe

fp [GLOBAL_OPTIONS] COMMAND [SUBCOMMAND] [ARGUMENTS] [OPTIONS]

Les options globales doivent précéder la commande :

fp --json sessions --since 24h

Exécutez fp COMMAND --help ou fp COMMAND SUBCOMMAND --help pour obtenir l’aide dans le terminal.

Commandes CLI

Authentification

Commande	Objectif	Options
`fp login`	Se connecter avec un code à usage unique envoyé par e-mail et sélectionner une organisation.	`--email`, `-e` ; `--org` ; `--force`
`fp logout`	Révoquer et supprimer la session utilisateur enregistrée.	—
`fp whoami`	Afficher l’identité actuelle, le mode d’authentification, l’organisation et les permissions.	—
`fp version`	Afficher la version de la CLI installée.	—
`fp help`	Afficher l’aide des commandes de premier niveau.	—

fp login --email you@example.com --org reliability-team
fp whoami

Événements

fp events [OPTIONS]

Liste les événements agents individuels. Le flux léger par défaut exclut les charges utiles brutes ; utilisez --full uniquement pour une investigation bornée.

Option	Description
`--limit`, `-n <n>`	Nombre maximum total de lignes. Par défaut : `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h`, ou `7d`.
`--from <timestamp>` / `--to <timestamp>`	Plage UTC ISO 8601 ; remplace `--since`.
`--env <value>`	Filtre d’environnement ; répétable ou séparé par des virgules.
`--event-type <value>`	Filtre par type d’événement ; répétable ou séparé par des virgules.
`--agent-id <value>`	Filtre par agent ; répétable ou séparé par des virgules.
`--session-id <value>`	Filtre par session ; répétable ou séparé par des virgules.
`--search <text>`	Recherche textuelle dans la charge utile ; répétable, correspondance sur n’importe quel terme.
`--order asc\|desc`	Ordre chronologique. Par défaut : du plus récent au plus ancien.
`--all`	Pagination automatique jusqu’à `--limit`.
`--cursor <token>`	Reprendre depuis un curseur opaque.
`--page-size <n>`	Lignes par requête avec `--all` ; maximum `200`.
`--full`	Inclure les charges utiles brutes via l’endpoint d’événements plus lourd.
`--fields <csv>`	Retourner uniquement les champs sélectionnés ; demander `payload` active le mode complet.

fp events --session-id <session-id> --order asc --all --limit 10000
fp --json events --full --session-id <session-id> --all --limit 10000

--all pagine jusqu’à --limit, dont la valeur par défaut est 50 — ainsi --all seul s’arrête à 50 lignes. Quand il s’arrête prématurément, la réponse contient un next_cursor pour reprendre ; "next_cursor": null signifie que le flux était réellement épuisé.

Sessions

fp sessions [OPTIONS]

Option	Description
`--limit`, `-n <n>`	Nombre maximum total de lignes. Par défaut : `50`.
`--since <window>`	`all`, `15m`, `1h`, `6h`, `24h`, ou `7d`.
`--from <timestamp>` / `--to <timestamp>`	Plage UTC ISO 8601 ; remplace `--since`.
`--env <value>`	Filtre d’environnement ; répétable ou séparé par des virgules.
`--status <value>`	`done`, `error`, ou `timeout` ; répétable ou séparé par des virgules.
`--agent-id <value>`	Correspond aux sessions impliquant l’un des agents sélectionnés.
`--session-id <value>`	Filtre par session ; répétable ou séparé par des virgules.
`--all`	Pagination automatique jusqu’à `--limit`.
`--cursor <token>`	Reprendre depuis un curseur opaque.
`--page-size <n>`	Lignes par requête avec `--all` ; maximum `200`.
`--fields <csv>`	Retourner uniquement les champs sélectionnés.
`--full-ids`	Ne pas raccourcir les identifiants de session dans la sortie terminal.
`--agents`	Développer le registre des agents pour les sessions multi-agents.

Évaluations

fp evals [OPTIONS]

Option	Description
`--aggregate`	Afficher les totaux et les statistiques par score au lieu des évaluations individuelles.
`--limit`, `-n <n>`	Nombre maximum de lignes dans la liste. Par défaut : `50`.
`--since`, `--from`, `--to`	Sélectionner la plage temporelle.
`--env`, `--status`, `--agent-id`, `--session-id`	Restreindre à une valeur exacte par filtre.
`--score KEY:MIN..MAX`	Plage de score ; répétable, toutes les plages doivent correspondre.
`--all`, `--cursor`, `--page-size`	Contrôler la pagination de la liste.
`--fields <csv>`	Retourner uniquement les champs sélectionnés.
`--full-ids`	Afficher les identifiants de session complets.
`--scores-full`	Afficher tous les scores dans la sortie terminal.

Erreurs

fp errors [OPTIONS]

Option	Description
`--aggregate`	Résumer les erreurs correspondantes au lieu de lister les lignes.
`--limit`, `-n <n>`	Nombre maximum de lignes dans la liste. Par défaut : `50`.
`--since`, `--from`, `--to`	Sélectionner la plage temporelle.
`--env`, `--error-type`, `--event-type`, `--agent-id`, `--session-id`	Restreindre la population d’erreurs.
`--search <text>`	Rechercher dans le texte de la charge utile ; répétable.
`--order asc\|desc`	Ordre chronologique.
`--all`, `--cursor`, `--page-size`	Contrôler la pagination de la liste.
`--fields <csv>`	Retourner uniquement les champs sélectionnés.
`--full-ids`	Afficher les identifiants de session complets.

Utilisation et valeurs de filtre

Commande	Objectif
`fp usage`	Afficher l’utilisation pour la fenêtre de mesure actuelle.
`fp list envs`	Lister les environnements observés.
`fp list agents`	Lister les identifiants d’agents observés.
`fp list event_types`	Lister les types d’événements.
`fp list score_filters`	Lister les clés de score d’évaluation.
`fp list models`	Lister les noms de modèles.
`fp list hooks`	Lister les noms de hooks.
`fp list tools`	Lister les noms d’outils.
`fp list error_types`	Lister les types d’erreurs.

Organisations

Commande	Objectif
`fp orgs list`	Lister les organisations accessibles.
`fp orgs switch [SLUG]`	Enregistrer une organisation active ; invite lorsqu’omis.
`fp orgs current`	Afficher l’organisation active.
`fp orgs perms`	Afficher vos permissions dans l’organisation active.

Clés API

Commande	Objectif	Options
`fp keys list`	Lister les clés de l’organisation.	`--show-id` ; `--fields <csv>`
`fp keys show NAME`	Afficher une clé et ses autorisations.	—
`fp keys create NAME`	Créer une clé et révéler son secret une seule fois.	`--permission-set` ; `--add` ; `--remove`
`fp keys update NAME`	Remplacer le jeu de permissions ou ajuster les autorisations.	`--permission-set` ; `--add` ; `--remove` ; `--yes`, `-y`
`fp keys regenerate NAME`	Faire tourner le secret et révéler le remplacement une seule fois.	`--yes`, `-y`
`fp keys disable NAME`	Révoquer définitivement une clé.	`--yes`, `-y`

Les jetons de permission utilisent le format resource:action, par exemple events:add. Répétez --add, séparez les jetons par des virgules, ou utilisez des actions avec point comme events:read.add.

Requêtes

Commande	Objectif	Options
`fp query list`	Lister les requêtes enregistrées.	`--show-id` ; `--fields <csv>`
`fp query show NAME`	Afficher une requête.	—
`fp query create NAME`	Enregistrer une requête.	`--sql <text\|@file>` ; `--description`
`fp query update NAME`	Mettre à jour ou renommer une requête.	`--name` ; `--sql` ; `--description` ; `--yes`, `-y`
`fp query delete NAME`	Supprimer une requête enregistrée.	`--yes`, `-y`
`fp query run [NAME]`	Exécuter une requête enregistrée ou du SQL ad hoc.	`--sql` ; `--limit` ; `--all` ; `--arg`, `--param`
`fp query schema [TABLE]`	Lister les tables interrogeables ou inspecter une table.	—

Utilisateurs

Commande	Objectif	Options
`fp users list`	Lister les membres de l’organisation.	`--active-only` ; `--show-id`
`fp users show EMAIL`	Afficher un membre et ses autorisations.	—
`fp users create EMAIL`	Ajouter un membre.	`--permission-set` ; `--add` ; `--remove`
`fp users update EMAIL`	Modifier les autorisations d’un membre.	`--permission-set` ; `--add` ; `--remove` ; `--yes`, `-y`
`fp users disable EMAIL`	Désactiver la connexion.	`--yes`, `-y`
`fp users enable EMAIL`	Réactiver la connexion.	`--yes`, `-y`

Paramètres

Commande	Objectif	Options
`fp settings list`	Lister les paramètres de l’organisation et leurs valeurs actuelles.	—
`fp settings schema`	Afficher les valeurs acceptées et leurs descriptions.	—
`fp settings set KEY`	Modifier un paramètre existant.	exactement l’un de `--value`, `--json-value`, `--file` ; `--yes`, `-y` optionnel

Alertes

Commande	Objectif	Options
`fp alerts list`	Lister les règles d’alerte.	`--show-id`
`fp alerts show NAME`	Afficher une alerte.	—
`fp alerts create NAME`	Créer une alerte.	`--file` ; `--description` ; `--severity` ; `--trigger-kind` ; `--trigger-spec` ; `--channels` ; `--eval-interval-secs` ; `--min-breaches` ; `--eval-window`
`fp alerts update NAME`	Mettre à jour ou renommer une alerte.	options de création plus `--name` ; `--yes`, `-y`
`fp alerts delete NAME`	Supprimer une alerte.	`--yes`, `-y`
`fp alerts test NAME`	Envoyer une notification de test.	`--channels` ; `--yes`, `-y`

Les niveaux de gravité des alertes sont info, warning et critical. Les types de déclencheur sont metric_threshold, custom_sql, evaluation_score, eval_compound et per_event. Les intervalles d’évaluation doivent être compris entre 30 et 86 400 secondes.

Audits

Commande	Objectif	Options
`fp audits list`	Lister les audits.	`--enabled-only` ; `--show-id`
`fp audits show NAME`	Afficher une définition d’audit et son état.	—
`fp audits create NAME`	Créer un audit et mettre immédiatement en file d’attente sa première exécution.	Voir options de création.
`fp audits edit NAME`	Remplacer les paramètres d’audit en conservant les valeurs non spécifiées.	options de définition de création ; `--name` ; `--yes`, `-y`
`fp audits delete NAME`	Supprimer un audit, ses résultats et son historique d’exécution.	`--yes`, `-y`
`fp audits run NAME`	Mettre en file d’attente une exécution manuelle.	—
`fp audits runs NAME`	Lister l’historique des exécutions.	`--limit`, `-n` ; `--show-id`
`fp audits context-show NAME`	Afficher le résumé et l’état de récupération des URL de référence.	—
`fp audits context-set NAME`	Modifier le résumé ou les URL de référence.	`--text` ; `--text-file` ; `--url` ; `--clear-urls`
`fp audits context-refresh NAME`	Récupérer à nouveau les URL de référence.	—
`fp audits findings`	Lister les résultats.	`--audit` ; `--run-id` ; `--status` ; `--limit`, `-n` ; `--offset` ; `--show-id`
`fp audits finding FINDING_ID`	Afficher un résultat et ses preuves.	—
`fp audits ack FINDING_ID`	Accuser réception d’un résultat.	`--reason`
`fp audits mute FINDING_ID`	Supprimer un motif récurrent.	`--reason` ; `--yes`, `-y`
`fp audits dismiss FINDING_ID`	Marquer un motif comme non exploitable et le supprimer.	`--reason` ; `--yes`, `-y`
`fp audits resolve FINDING_ID`	Marquer un résultat comme corrigé sans suppression future.	`--yes`, `-y`
`fp audits reopen FINDING_ID`	Remettre un résultat dans la file active et effacer la suppression.	—
`fp audits assign FINDING_ID`	Définir le responsable du résultat.	`--to <email>` obligatoire

Options de création d’audit

fp audits create checkout-reliability \
  --description "Find checkout failures that agents do not recover from" \
  --scope '{"environments":["production"],"agent_ids":["checkout-agent"]}' \
  --schedule-interval-secs 86400 \
  --window-mode since_last \
  --sensitivity medium \
  --text-file ./checkout-audit-brief.txt \
  --url https://runbooks.example.com/checkout

Option	Description
`--file <path>`	Baser la définition sur du JSON, ou utiliser `-` pour stdin. Les indicateurs explicites remplacent les valeurs du fichier.
`--description <text>`	Énoncer la question d’échec ou l’objectif.
`--enabled` / `--disabled`	Démarrer la planification activée ou désactivée. Par défaut : activée.
`--schedule-interval-secs <n>`	`3600`–`604800`. Par défaut : `86400`.
`--schedule-anchor <timestamp>`	Phase UTC fixe au format ISO 8601. Par défaut : prochain 09:00 UTC.
`--window-mode since_last\|fixed`	Continuer après la dernière fenêtre entièrement analysée ou inspecter répétitivement une fenêtre glissante. Par défaut : `since_last`.
`--lookback-window-secs <n>`	`3600`–`7776000`. Par défaut : `604800`.
`--scope '<json>'`	Filtrer par `environments`, `agent_ids`, ou d’autres champs de portée pris en charge.
`--ignore-error-type <type>`	Exclure des types d’erreurs ; répétable ou séparé par des virgules.
`--llm` / `--no-llm`	Activer ou désactiver l’analyse agentique. Par défaut : activée.
`--top-k <n>`	Conserver `1`–`500` résultats. Par défaut : `50`.
`--sensitivity low\|medium\|high`	Définir la sensibilité des rapports. Par défaut : `medium`.
`--channels '<json>'`	Tableau de canaux de notification.
`--text <brief>`	Résumé en ligne, maximum 8 192 caractères.
`--text-file <path>`	Lire le résumé depuis un fichier ; mutuellement exclusif avec `--text`.
`--url <https-url>`	Ajouter une référence HTTPS publique ; répétable jusqu’à cinq fois.

Incluez le contexte lors de la création si la première exécution en a besoin. La création valide la définition et le contexte ensemble avant le début de l’exécution mise en file d’attente.

fp audits run est asynchrone. Interrogez fp audits runs NAME jusqu’à ce que la dernière exécution réussisse ou échoue avant de lire ses résultats.

Problèmes

Commande	Objectif	Options
`fp issues list`	Lister les problèmes.	`--state` ; `--alert-id` ; `--limit`, `-n` ; `--show-id`
`fp issues count`	Compter les problèmes ouverts ou les états de problème sélectionnés.	`--state`
`fp issues show INCIDENT_ID`	Afficher les détails d’un problème, ses commentaires, abonnés et activité.	—
`fp issues open`	Ouvrir un problème manuel ou lié à une alerte.	`--summary` obligatoire ; `--title`, `--alert-id`, `--severity` optionnels
`fp issues ack INCIDENT_ID`	Accuser réception d’un problème.	—
`fp issues assign INCIDENT_ID`	Remplacer les assignés ; omettez l’option pour les effacer.	`--assignee` répétable
`fp issues resolve INCIDENT_ID`	Résoudre un problème.	`--yes`, `-y`
`fp issues comment-list INCIDENT_ID`	Lister les commentaires.	—
`fp issues comment-add INCIDENT_ID`	Ajouter un commentaire.	exactement l’un de `--body`, `--file`
`fp issues comment-delete INCIDENT_ID COMMENT_ID`	Supprimer un commentaire.	`--yes`, `-y`
`fp issues subscribers INCIDENT_ID`	Lister les abonnés.	—
`fp issues subscribe INCIDENT_ID`	S’abonner soi-même ou un autre opérateur.	`--email`
`fp issues unsubscribe INCIDENT_ID`	Supprimer un abonnement.	`--email`

Les états de problème valides sont firing, acknowledged et resolved. Les niveaux de gravité des problèmes autonomes sont info, warning et critical.

Assistant cloud

Commande	Objectif	Options
`fp agent health`	Vérifier la disponibilité et la configuration de l’assistant.	—
`fp agent models`	Lister les modèles d’assistant disponibles.	—
`fp agent chats`	Lister les conversations enregistrées.	—
`fp agent ask [MESSAGE]`	Démarrer ou poursuivre une conversation ; lit stdin lorsque le message est omis.	`--chat` ; `--model` ; `--page-context`
`fp agent show CHAT_ID`	Afficher une conversation enregistrée.	—
`fp agent rename CHAT_ID`	Renommer une conversation.	`--title` obligatoire
`fp agent delete CHAT_ID`	Supprimer une conversation.	`--yes`, `-y`

Politiques

Versions de politiques gérées depuis le cloud. Session uniquement — chaque commande ici sort avec le code 2 sous une clé API, avant toute requête, car ce sont des routes d’écriture réservées aux root délibérément absentes de /v1.

Commande	Objectif	Options
`fp policies list`	Lister les versions de politiques.	`--json`
`fp policies show POLICY_ID`	Afficher une politique avec sa source.	—
`fp policies publish NAME PATH`	Créer une version à partir d’un `.mjs` local.	`--description` ; `--no-verify`
`fp policies enable POLICY_ID`	La rajouter à chaque déploiement dont elle avait été retirée, en créant une nouvelle génération sur chacun.	`--yes`, `-y`
`fp policies disable POLICY_ID`	La retirer de chaque déploiement qui la porte, en créant une nouvelle génération sur chacun.	`--yes`, `-y`
`fp policies delete POLICY_ID`	Supprimer une version de politique.	`--yes`, `-y`
`fp policies test PATH`	Exécuter une politique localement contre un contexte synthétique. Applique le filtre `match` de chaque politique, donc une politique qui ne couvre pas l’événement/outil donné est signalée comme `skipped` plutôt qu’exécutée.	`--event` ; `--tool` ; `--command` ; `--file` ; `--expect`
`fp policies compose PROMPT`	Rédiger une politique avec l’assistant. Nécessite `policies:write`.	—

Flotte

Quelles machines exécutent quelles politiques. Session uniquement, pour la même raison que ci-dessus.

Commande	Objectif	Options
`fp fleet list`	Lister les machines enrôlées et leur génération de déploiement.	—
`fp fleet show MACHINE_ID`	L’ensemble de politiques qu’une machine exécute actuellement.	—
`fp fleet deploy MACHINE_ID`	Remplace l’ensemble complet de politiques de la machine. Affiche le plan et demande confirmation uniquement sur un terminal interactif sans `--json`.	`--add` ; `--remove` ; `--set` ; `--create` ; `--yes`, `-y`
`fp fleet diff MACHINE_ID`	Comparer une machine à un autre déploiement.	—
`fp fleet history MACHINE_ID`	Déploiements passés pour une machine.	—
`fp fleet rollback MACHINE_ID GENERATION`	Rétablir l’ensemble de politiques d’une génération passée, comme nouvelle génération.	`--yes`, `-y`
`fp fleet rename MACHINE_ID`	Donner un nom lisible à une machine.	`--name` obligatoire

Garde-fous

Ce que l’application a réellement fait. Session uniquement, pour la même raison que ci-dessus.

Commande	Objectif	Options
`fp guardrails summary`	Couverture, totaux bloqués/évalués, sparkline des refus et tableau par politique.	`--since` (`1h`, `6h`, `24h`, `7d`) ; `--machine`
`fp guardrails timeline`	Décisions regroupées sur la fenêtre, totalisées pour toutes les sources de politique.	`--since` (`1h`, `6h`, `24h`, `7d`) ; `--machine`

Indicateurs globaux

Indicateur	Description
`--json`	Émettre du JSON lisible par machine.
`--base-url <url>`	Utiliser un tableau de bord auto-hébergé ou de développement.
`--org <slug>`	Sélectionner une organisation pour cette invocation.
`--token <token>`	Remplacer le jeton de session utilisateur enregistré.
`--api-key <key>`	Authentifier l’automatisation avec une clé API ; jamais enregistrée.
`--timeout <seconds>`	Délai HTTP ; doit être positif. Par défaut : `30`.
`--quiet`, `-q`	Supprimer la sortie de statut sur stderr.
`--no-color`	Désactiver la sortie colorée.
`--insecure` / `--secure`	Désactiver ou restaurer la vérification des certificats TLS.
`--version`	Afficher la version non emballée et quitter.
`--help`, `-h`	Afficher l’aide.

--api-key est destiné à l’automatisation. La connexion, le changement d’organisation et les commandes d’assistant nécessitent une session utilisateur.

Variables d’environnement

Variable	Équivalent ou objectif
`FP_DASHBOARD_URL`	`--base-url`
`FP_ORG`	`--org`
`FP_TOKEN`	`--token`
`FP_API_KEY`	`--api-key`
`FP_JSON`	`--json`
`FP_INSECURE`	`--insecure`
`FP_HOME`	Déplacer le répertoire de configuration de la CLI (par défaut `~/.failproofai/fpcli`).
`FP_ANALYTICS_DISABLED` ou `DO_NOT_TRACK`	Désactiver les analyses CLI anonymes.
`NO_COLOR`	Désactiver la sortie colorée.

Les indicateurs explicites remplacent les variables d’environnement, qui remplacent la configuration enregistrée. En mode clé API, sélectionnez le tenant explicitement avec --org ou FP_ORG.

Les orthographes AGENTEYE_* de ces variables ne sont pas lues par fp et ne l’ont jamais été — la CLI déclare FP_* (fp_cli/app.py), et une variable inconnue n’est pas une erreur. Définir AGENTEYE_DASHBOARD_URL ne redirige pas la CLI ; elle est ignorée et la commande s’exécute silencieusement contre le tableau de bord enregistré.AGENTEYE_HOME et AGENTEYE_ENVIRONMENT existent toujours, mais ils appartiennent au collecteur et au SDK de télémétrie, pas à cette CLI.

Les commandes qui suppriment, révoquent, inhibent, résolvent ou remplacent une configuration demandent confirmation par défaut. N’utilisez --yes qu’après avoir vérifié l’organisation active et la cible.

Connect your agents

Reference

Se connecter

Syntaxe

Commandes CLI

Authentification

Événements

Sessions

Évaluations

Erreurs

Utilisation et valeurs de filtre

Organisations

Clés API

Requêtes

Utilisateurs

Paramètres

Alertes

Audits

Options de création d’audit

Problèmes

Assistant cloud

Politiques

Flotte

Garde-fous

Indicateurs globaux

Variables d’environnement

​Se connecter

​Syntaxe

​Commandes CLI

​Authentification

​Événements

​Sessions

​Évaluations

​Erreurs

​Utilisation et valeurs de filtre

​Organisations

​Clés API

​Requêtes

​Utilisateurs

​Paramètres

​Alertes

​Audits

​Options de création d’audit

​Problèmes

​Assistant cloud

​Politiques

​Flotte

​Garde-fous

​Indicateurs globaux

​Variables d’environnement

Se connecter

Syntaxe

Commandes CLI

Authentification

Événements

Sessions

Évaluations

Erreurs

Utilisation et valeurs de filtre

Organisations

Clés API

Requêtes

Utilisateurs

Paramètres

Alertes

Audits

Options de création d’audit

Problèmes

Assistant cloud

Politiques

Flotte

Garde-fous

Indicateurs globaux

Variables d’environnement