// 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.
curl -fsSL https://konsolity.com/cli/install.sh | shirm https://konsolity.com/cli/install.ps1 | iexbrew 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.
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.
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.
Choose the scope
Hosts, snippets, sessions, MCP; read only or full access; command rules; expiry from one day to one year, or never.
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 mcpWith 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 login | Activates the machine with a code approved from your account. |
konsolity status | Account, machine, scope, expiry, token age and reachable hosts. |
konsolity hosts | Lists 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 · run | Lists the snippets or runs one on a host. |
konsolity sessions [--follow] | Follows the CLI sessions running on the account or ends one. |
konsolity mcp | Local MCP server (stdio) for Claude. |
konsolity serve | Picks up the Claude connector queue, as a system service. |
konsolity setup-token | Long-lived token for a CI or a container, shown only once. |
konsolity update | Updates the binary after checking the signature. |
konsolity logout | Revokes 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.
// 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.