Manage CLI machines

Updated on November 10, 2026

The list of CLI machines

In the app: Settings › CLI machines. On the web: https://app.konsolity.com/cli-machines. Each entry shows:

Column Content
Name Name given on activation, editable
Type Machine (konsolity login) or Long-lived token (konsolity setup-token)
System OS, architecture, host name, CLI version
IP Last IP address seen
Activated on Date of the approval
Last activity Last call of the machine
Online Heartbeat or call less than a minute ago
Expiry Date, or "Never"
Scope Domains, read-only or full, number of hosts and snippets
Sessions Commands running (run, snippet, mcp, serve, sessions --follow)

The list stays available even without the Studio plan, so that you can always revoke.

Rename

Tap the name of the machine to change it. The new name shows at once in the list, the log and the messages sent to Claude.

Change the scope

Scope opens the domains, hosts, snippets, command rules and maximum timeout (vault open). Widening the scope asks for the second factor; narrowing it is immediate. See Scope and rules.

Change the expiry

Choose a new duration: 1 day, 7 days, 30 days, 90 days, 1 year or never (1 year at most for a long-lived token). On the due date, the server refuses the token and the machine stops until a new activation.

End a session

Each running session shows the command and how long it has been running. End stops it: the CLI cuts the open SSH connections, kills the command and exits with code 77, in less than 5 seconds. The machine stays active. From another machine that has the sessions domain:

konsolity sessions end a1b2c3

Revoke a machine

Revoke cuts the machine off in one click, unconditionally:

  • in less than 5 seconds, running commands are stopped and the CLI exits with code 77;
  • the CLI erases its token, its machine key and its local copies;
  • the server deletes the encrypted copies of its machine vault and refuses every later call;
  • the event is written to the security log of the account.

Revocation is final: to use the machine again, a new activation is needed.

Revoke all

Revoke all revokes every CLI machine and every long-lived token of the account at once.

Account-wide revocations cut them off too: changing the password with "Sign out other devices", recovering the account, deleting the account.

Sign out from the machine

konsolity logout

The machine revokes itself on the server, then erases everything locally. Remember sudo konsolity service uninstall if you retire the machine for good.

Alerts

You are told about every sensitive event:

  • new machine activated (name, system, IP address);
  • different fingerprint: a token used from another computer than the one it was activated on (the token is refused);
  • revocation of a machine;
  • confirmation request for a destructive command, with the link to answer.

Each alert arrives by email in the language of the account and as an app notification. To also receive it on Telegram, link your chat in Security › Telegram alerts (optional).

If you do not recognize an activation, revoke the machine, then change your password while signing out the other devices.