Access

Overview

You sign in to the console in a browser. The kode CLI signs in with a device code that you approve in the console. The SDKs use the CLI login of the computer they run on, or an API token that you set in KODE_TOKEN.

Your handle identifies your account in every address, for example alice/api for a repository. You choose it after the first sign-in.

Sign-in methods

A handle has 3 to 39 characters: lowercase letters, digits, and -, with no - at the start or end. Accounts and teams share one set of handles.

Install

The install script puts kode and kd-tui in ~/.local/bin and verifies each file against the release checksum. It supports macOS and Linux on x86_64 and arm64, and needs no administrator rights. kd-tui is not available on Linux arm64.

Tasks

Install kode

Reason for the task

Install the CLI on your computer.

Job set-up

• Access: you.
• References: kode.

Procedure

1. Run the install script.

   CLICopy

   curl -fsSL https://dev.kloudlite.io/install.sh | sh

2. If the script prints Add it to your PATH, run the export line it shows and add it to your shell profile.

Close-out

1. Run kode --version. It prints the version.

Sign in with kode

Reason for the task

Give the CLI and the SDKs a login for your account.

Job set-up

• Access: you. Only you can approve the code.
• References: kode login.

Procedure

1. Run the login command. It opens the approval page in your browser.

   CLICopy

   kode login

2. Make sure that the page shows the name of your computer, then select Approve.

Close-out

1. Make sure that the command prints Logged in as and your handle.

Sign out of kode

Reason for the task

Remove the login from a computer.

Job set-up

• Access: you.
• References: kode logout.

Procedure

1. Run the logout command. It revokes the login and deletes ~/.config/kode/config.json.

   CLICopy

   kode logout

Close-out

1. Make sure that the command prints Logged out.

Revoke a CLI login

Reason for the task

End the login of a computer that you no longer use.

Job set-up

• Access: you.
• References: GET /v1/cli/tokens, DELETE /v1/cli/tokens/{id}.

Procedure

1. Show your CLI logins. The name is the computer.

   PythonCopy

   from kloudlite import Kodekl = Kloudlite()for t in kl.request("GET", "/v1/cli/tokens"):    print(t["id"], t["name"], t["expiresAt"])

   TypeScriptCopy

   import { Kode } from "./index.ts";const kl = new Kloudlite();const tokens = (await kl.request("GET", "/v1/cli/tokens")) as { id: string; name: string; expiresAt: string }[];for (const t of tokens) console.log(t.id, t.name, t.expiresAt);

   GoCopy

   kl := kloudlite.New(kloudlite.Options{})var tokens []map[string]anyif err := kl.Request("GET", "/v1/cli/tokens", kloudlite.RequestOptions{Out: &tokens}); err != nil {    log.Fatal(err)}for _, t := range tokens {    fmt.Println(t["id"], t["name"], t["expiresAt"])}

   RubyCopy

   require_relative "kloudlite"kl = Kloudlite::Client.newkl.request("GET", "/v1/cli/tokens").each { |t| puts [t["id"], t["name"], t["expiresAt"]].join(" ") }

   JavaCopy

   var kl = new Kloudlite();System.out.println(kl.request("GET", "/v1/cli/tokens"));

   CLICopy

   kode request GET /v1/cli/tokens

2. Delete the login. Replace {id} with the id of the login.

   PythonCopy

   kl.request("DELETE", "/v1/cli/tokens/{id}")

   TypeScriptCopy

   await kl.request("DELETE", "/v1/cli/tokens/{id}");

   GoCopy

   if err := kl.Request("DELETE", "/v1/cli/tokens/{id}", kloudlite.RequestOptions{}); err != nil {    log.Fatal(err)}

   RubyCopy

   kl.request("DELETE", "/v1/cli/tokens/{id}")

   JavaCopy

   kl.request("DELETE", "/v1/cli/tokens/{id}");

   CLICopy

   kode request DELETE /v1/cli/tokens/{id}

Close-out

1. Show the logins again. Make sure that the id is gone.

Troubleshooting