Skip to content
kexsh

kexsh login / logout

Connect your local kexsh installation to kexsh cloud.

kexsh login

Section titled “kexsh login”

Authenticate using the Device Authorization flow (RFC 8628). No password is entered in the terminal — you approve the login in your browser.

Terminal window
kexsh login
Open this URL in your browser: https://app.kex.sh/device
Enter code: ABCD-1234


Waiting for authorization...
Login successful ✓
Device registered: my-macbook

What happens

Section titled “What happens”
  1. kexsh requests a device code from the server
  2. You open the URL and enter the code in your browser
  3. You sign in with GitHub and approve the request
  4. kexsh receives a session token and stores it locally
  5. Your device is registered with kexsh cloud

The token is saved to ~/.config/kexsh/credentials.json with 0600 permissions.

kexsh logout

Section titled “kexsh logout”

Revoke your session and delete the local token.

Terminal window
kexsh logout
Logged out ✓

This revokes the server-side session and removes credentials.json. Your terminals continue running locally but cloud sync stops.

See also

Section titled “See also”