Skip to content

// konsolity cli

Konsolity on the command line, on your servers.

Like Claude Code in a terminal: the konsolity binary installs in one line on a Linux server, a Mac or Windows, is activated with a code approved from your account, then gives access to the hosts, snippets and sessions you entrust to it. It also serves as a local MCP server for Claude agents.

// install

One line to install.

Linux x64 and arm64, macOS on Intel and Apple silicon, Windows x64. The installers check the SHA-256 checksum and the publisher signature before installing anything.

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

.deb and .rpm packages for Debian, Ubuntu, Fedora, RHEL and derivatives, .tar.gz and .zip archives, with their SHA-256 checksum: Download

// activation

Activated with a code, never with a password.

No password and no key is ever typed on the machine.

1

Run konsolity login

The command shows an address, an XXXX-XXXX code and the machine fingerprint, with a QR code when the terminal allows it.

2

Approve from your account

Enter the code in the app (Settings, CLI machines) or open app.konsolity.com/cli/activate, and check that the fingerprint is the same as in the terminal.

3

Choose the scope

Hosts, snippets, sessions, MCP; read only or full access; command rules; expiry from one day to one year, or never.

4

Confirm with a second factor

Two-factor code or passkey, in the same approval. Without a second factor on the account, no machine can be activated.

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

$ konsolity status

// scope

The machine only sees what you entrust to it.

The scope is chosen at activation and changed later from the CLI machines page. Widening it takes a second factor, narrowing it is immediate.

Hosts

The chosen hosts, their identities and their pinned host keys. A host outside the scope is never copied to the machine.

Snippets

The chosen snippets, to list or to run on a host of the scope.

Sessions

The CLI sessions running on the account, to follow or to end.

MCP

The local MCP server for Claude Code and Claude agents, and the Claude connector queue with konsolity serve.

Read only or full access

Read only, the machine lists and shows status without running any command. With full access, it runs what your rules allow.

Command rules

Allowed patterns (exact, prefix or glob) and maximum duration. The server and the machine both refuse what is not allowed.

// security

A machine vault, end-to-end encrypted.

Konsolity CLI keeps the Konsolity model: the server reads neither your hosts, nor your keys, nor your rules.

The vault key stays on your devices

The machine never receives the key of your vault. The approving device hands it a machine key sealed for it alone, then encrypted copies of the allowed items only.

Bound to the machine

The token is bound to the machine fingerprint: copied elsewhere, it is refused and you are alerted. Local secrets are encrypted with a key specific to the machine.

Automatic rotation

The token is renewed automatically every 24 hours, with no interruption of service.

Revocation in under 5 seconds

Revoke a machine or end a session from the app or your account: connections cut, command stopped, local secrets erased.

Destructive commands confirmed

rm -rf, DROP, reboot, terraform destroy and the other destructive commands wait for your approval in the app, whatever the scope. Without an answer within 5 minutes, nothing runs.

Everything is logged

Activation, every command and its exit code, confirmations, rotations, revocation. Never the output nor a secret. CSV or JSON export.

Alerts

New machine, different fingerprint, revocation, confirmation request: by email, in the app and on Telegram if you have linked it.

Second factor required

Activating a machine or widening its scope requires a two-factor code or a passkey.

// mcp

A local MCP server for Claude.

konsolity mcp gives Claude Code and Claude agents the tools list_hosts, list_snippets, run_command, run_snippet and list_sessions, with the same scope, the same rules and the same confirmations. One line is enough to plug it in.

$ claude mcp add konsolity -- konsolity mcp

With konsolity serve, the machine also picks up the Claude connector queue of your account, as the desktop app does, without the app being open. Claude connector

// commands

The main commands.

konsolity loginActivates the machine with a code approved from your account.
konsolity statusAccount, machine, scope, expiry, token age and reachable hosts.
konsolity hostsLists the hosts of the scope, without any secret.
konsolity run <host> -- <command>Runs a command over SSH on a host, live output and exit code passed on.
konsolity snippet list · runLists the snippets or runs one on a host.
konsolity sessions [--follow]Follows the CLI sessions running on the account or ends one.
konsolity mcpLocal MCP server (stdio) for Claude.
konsolity servePicks up the Claude connector queue, as a system service.
konsolity setup-tokenLong-lived token for a CI or a container, shown only once.
konsolity updateUpdates the binary after checking the signature.
konsolity logoutRevokes the machine and erases everything locally.

// studio

Included in the Studio plan.

Studio costs €99 a month or €999 a year. Konsolity CLI is reserved for Studio and its 7-day free trial, like the Claude connector. The server checks the plan on every call of the machine.

7-day free trial Installation guide Claude connector

// faq

Frequently asked questions

Can the Konsolity server read what the machine receives?

No. The items copied for the machine are encrypted with a machine key that only your devices and the machine know. The server only stores opaque blocks, and the machine never receives the key of your vault.

What if the machine is stolen or compromised?

Revoke it from the CLI machines page: it is cut off in under 5 seconds and its copies are erased from the server. Only the hosts of its scope are concerned; change their SSH keys as a precaution.

Does the app need to stay open?

No. The machine works on its own within its scope. The app is used to activate it, change its scope and confirm destructive commands, and it can be on your phone.

Which systems are supported?

Linux x64 and arm64 (Debian, Ubuntu, Fedora, RHEL and derivatives, or any distribution through the archive), macOS on Intel and Apple silicon, and Windows x64.

Can I use it in a CI or a container?

Yes, with konsolity setup-token: a long-lived token, shown only once, to keep in your secrets manager and to provide through KONSOLITY_TOKEN. It has a scope, a log and a revocation like a machine.

Which plan do I need?

Studio, 7-day free trial included. Activating a machine also requires two-factor authentication or a passkey on the account.