Install Konsolity CLI

Updated on November 10, 2026

Konsolity CLI is the konsolity command, to install on a server or on a machine without a graphical interface. Once activated from your account, it gives access to the hosts, snippets and sessions of your vault within the scope you gave it, and serves as a local MCP server for Claude agents (Claude Code for example). It works like Claude Code on the command line: install it, activate it once with a code, then use it.

Required plan

Konsolity CLI is reserved for the Studio plan and its free trial. The server checks the plan on every call of the machine: without it, every command answers "Subscription required". The machine list and revocation always stay available, even without the plan.

Choose the machine

Any computer that can reach your hosts over SSH: an administration server, a small virtual machine, a Mac mini, a development workstation, a CI runner. The machine needs no inbound port, only outbound HTTPS access to api.konsolity.com.

System Architectures Formats
Linux (Debian, Ubuntu, Fedora, RHEL and derivatives, any distribution through the archive) x64, arm64 script, .deb, .rpm, .tar.gz
macOS (Intel and Apple silicon) one archive per architecture (x64, arm64), Developer ID signed and notarized binary · macOS 11 or later script, Homebrew, .tar.gz
Windows x64 PowerShell script, .zip

Linux and macOS: install script

The simplest way. The script detects the system and the architecture, downloads the right file, checks its SHA-256 hash and the publisher's Ed25519 signature, then installs it:

curl -fsSL https://konsolity.com/cli/install.sh | sh

To read the script before running it:

curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh

The script stops without installing anything if the hash or the signature do not match.

Linux: .deb package (Debian, Ubuntu)

Download the package for your architecture, then:

sudo apt install ./konsolity_<version>_amd64.deb

On arm64 (Raspberry Pi 4 or 5, Graviton or Ampere servers), take konsolity_<version>_arm64.deb. Updates then go through apt.

Linux: .rpm package (Fedora, RHEL, Rocky, Alma)

sudo dnf install ./konsolity-<version>.x86_64.rpm

On arm64, the file ends with .aarch64.rpm. Updates then go through dnf.

Linux: .tar.gz archive

For any other distribution, the archive contains the binary alone:

tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity

Replace amd64 with arm64 on an ARM machine.

macOS: Homebrew

brew install konsolity/tap/konsolity

Updates then go through brew upgrade konsolity. The install script and the konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) archive work too.

Windows: PowerShell

In PowerShell (no administrator rights needed):

irm https://konsolity.com/cli/install.ps1 | iex

The script makes the same checks as on Linux, installs konsolity.exe in your profile and adds it to the user PATH. Open a new terminal to use it.

Windows: .zip archive

The konsolity_<version>_windows_amd64.zip archive contains konsolity.exe. Extract it into a folder of your choice, then add that folder to your PATH.

Check a download

Each version is described by the signed manifest https://konsolity.com/cli/latest.json: version, list of files (system, architecture, format, address, SHA-256 hash) and the publisher's Ed25519 signature. The scripts and konsolity update refuse a file whose hash or signature does not match. To check a package you downloaded by hand yourself:

curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb

On macOS, use shasum -a 256; on Windows, Get-FileHash konsolity_<version>_windows_amd64.zip. The hash shown must be exactly the one in the manifest.

Check the installation

konsolity version

The command shows the version, the system and the architecture.

Update

konsolity update

konsolity update reads the manifest, checks the hash and the signature of the new version, then replaces the binary. If konsolity was installed with apt, dnf or Homebrew, the command points you to that package manager instead of replacing the file itself.

If the systemd service is installed, run sudo konsolity update: it updates /usr/local/bin/konsolity, then restarts the service. The konsolity-update.timer timer also does it on its own twice a day.

Next

  1. Activate the machine with a code approved from your account.
  2. Choose its scope: hosts, snippets, command rules.
  3. Discover the commands, connect Claude Code, or run it as a service.