Aller au contenu

// konsolity cli

Konsolity en ligne de commande, sur vos serveurs.

Comme Claude Code dans un terminal : le binaire konsolity s'installe en une ligne sur un serveur Linux, un Mac ou Windows, s'active par un code validé depuis votre compte, puis donne accès aux hôtes, snippets et sessions que vous lui confiez. Il sert aussi de serveur MCP local aux agents Claude.

// installation

Une ligne pour installer.

Linux x64 et arm64, macOS sur Intel et Apple silicon, Windows x64. Les installateurs vérifient l'empreinte SHA-256 et la signature de l'éditeur avant d'installer quoi que ce soit.

Linux et macOScurl -fsSL https://konsolity.com/cli/install.sh | sh
Windows (PowerShell)irm https://konsolity.com/cli/install.ps1 | iex
Homebrewbrew install konsolity/tap/konsolity

Paquets .deb et .rpm pour Debian, Ubuntu, Fedora, RHEL et dérivés, archives .tar.gz et .zip, avec leur empreinte SHA-256 : Télécharger

// activation

Activée par un code, jamais par un mot de passe.

Aucun mot de passe ni aucune clé n'est saisi sur la machine.

1

Lancez konsolity login

La commande affiche une adresse, un code XXXX-XXXX et l'empreinte de la machine, avec un QR code si le terminal le permet.

2

Validez depuis votre compte

Saisissez le code dans l'app (Réglages, Machines CLI) ou ouvrez app.konsolity.com/cli/activate, et vérifiez que l'empreinte est la même que dans le terminal.

3

Choisissez la portée

Hôtes, snippets, sessions, MCP ; lecture seule ou accès complet ; règles de commande ; expiration d'un jour à un an, ou jamais.

4

Confirmez par un second facteur

Code de double authentification ou clé d'accès, dans la même validation. Sans second facteur sur le compte, aucune machine ne peut être activée.

$ konsolity login --name web-01
  https://app.konsolity.com/cli/activate
  code         KQ7M-4TZP
  fingerprint  9F3A-C21D

$ konsolity status

// portée

La machine ne voit que ce que vous lui confiez.

La portée se choisit à l'activation et se modifie ensuite depuis la page Machines CLI. L'élargir demande un second facteur, la réduire est immédiat.

Hôtes

Les hôtes choisis, leurs identités et leurs clés d'hôte épinglées. Un hôte hors portée n'est jamais copié sur la machine.

Snippets

Les snippets choisis, à lister ou à lancer sur un hôte de la portée.

Sessions

Les sessions CLI en cours sur le compte, à suivre ou à terminer.

MCP

Le serveur MCP local pour Claude Code et les agents Claude, et la file du connecteur Claude avec konsolity serve.

Lecture seule ou accès complet

En lecture seule, la machine liste et affiche l'état sans lancer aucune commande. En accès complet, elle exécute ce que vos règles autorisent.

Règles de commande

Motifs autorisés (exact, préfixe ou glob) et durée maximale. Le serveur et la machine refusent tous deux ce qui n'est pas permis.

// sécurité

Un coffre de machine, chiffré de bout en bout.

Konsolity CLI garde le modèle de Konsolity : le serveur ne lit ni vos hôtes, ni vos clés, ni vos règles.

La clé du coffre reste sur vos appareils

La machine ne reçoit jamais la clé de votre coffre. L'appareil qui approuve lui remet une clé de machine scellée pour elle seule, puis des copies chiffrées des seuls éléments autorisés.

Liée à la machine

Le jeton est lié à l'empreinte de la machine : copié ailleurs, il est refusé et vous êtes alerté. Les secrets locaux sont chiffrés par une clé propre à la machine.

Rotation automatique

Le jeton est renouvelé automatiquement toutes les 24 heures, sans interruption de service.

Révocation en moins de 5 secondes

Révoquez une machine ou terminez une session depuis l'app ou votre compte : connexions coupées, commande arrêtée, secrets locaux effacés.

Commandes destructrices confirmées

rm -rf, DROP, reboot, terraform destroy et les autres commandes destructrices attendent votre accord dans l'app, quelle que soit la portée. Sans réponse en 5 minutes, rien n'est exécuté.

Tout est journalisé

Activation, chaque commande et son code retour, confirmations, rotations, révocation. Jamais la sortie ni un secret. Export CSV ou JSON.

Alertes

Nouvelle machine, empreinte différente, révocation, demande de confirmation : par e-mail, dans l'app et sur Telegram si vous l'avez relié.

Second facteur obligatoire

Activer une machine ou élargir sa portée exige un code de double authentification ou une clé d'accès.

// mcp

Un serveur MCP local pour Claude.

konsolity mcp donne à Claude Code et aux agents Claude les outils list_hosts, list_snippets, run_command, run_snippet et list_sessions, avec la même portée, les mêmes règles et les mêmes confirmations. Une ligne suffit pour le brancher.

$ claude mcp add konsolity -- konsolity mcp

Avec konsolity serve, la machine relève aussi la file du connecteur Claude de votre compte, comme l'app d'ordinateur, sans que celle-ci soit ouverte. Connecteur Claude

// commandes

Les commandes principales.

konsolity loginActive la machine par un code validé depuis votre compte.
konsolity statusCompte, machine, portée, expiration, âge du jeton et hôtes accessibles.
konsolity hostsListe les hôtes de la portée, sans aucun secret.
konsolity run <host> -- <command>Exécute une commande par SSH sur un hôte, sortie en direct et code retour transmis.
konsolity snippet list · runListe les snippets ou en lance un sur un hôte.
konsolity sessions [--follow]Suit les sessions CLI en cours sur le compte ou en termine une.
konsolity mcpServeur MCP local (stdio) pour Claude.
konsolity serveRelève la file du connecteur Claude, en service système.
konsolity setup-tokenJeton longue durée pour une CI ou un conteneur, affiché une seule fois.
konsolity updateMet à jour le binaire après vérification de la signature.
konsolity logoutRévoque la machine et efface tout localement.

// studio

Inclus dans l'offre Studio.

Studio coûte 99 € par mois ou 999 € par an. Konsolity CLI est réservé à Studio et à son essai gratuit de 7 jours, comme le connecteur Claude. Le serveur vérifie l'offre à chaque appel de la machine.

Essai gratuit de 7 jours Guide d'installation Connecteur Claude

// faq

Questions fréquentes

Le serveur Konsolity peut-il lire ce que reçoit la machine ?

Non. Les éléments copiés pour la machine sont chiffrés par une clé de machine que seuls vos appareils et la machine connaissent. Le serveur ne stocke que des blocs opaques, et la machine ne reçoit jamais la clé de votre coffre.

Et si la machine est volée ou compromise ?

Révoquez-la depuis la page Machines CLI : elle est coupée en moins de 5 secondes et ses copies sont effacées du serveur. Seuls les hôtes de sa portée sont concernés ; changez leurs clés SSH par prudence.

Faut-il garder l'app ouverte ?

Non. La machine travaille seule dans la limite de sa portée. L'app sert à l'activer, à modifier sa portée et à confirmer les commandes destructrices, et elle peut être sur votre téléphone.

Quels systèmes sont pris en charge ?

Linux x64 et arm64 (Debian, Ubuntu, Fedora, RHEL et dérivés, ou toute distribution par l'archive), macOS sur Intel et Apple silicon, et Windows x64.

Puis-je l'utiliser dans une CI ou un conteneur ?

Oui, avec konsolity setup-token : un jeton longue durée, affiché une seule fois, à ranger dans votre gestionnaire de secrets et à fournir par KONSOLITY_TOKEN. Il a une portée, un journal et une révocation comme une machine.

Quelle offre faut-il ?

Studio, essai gratuit de 7 jours compris. Activer une machine demande aussi la double authentification ou une clé d'accès sur le compte.