TELESCOPE-IDENTITY(1)

📦 version 0.11, in nixos 26.05, nixpkgs unstable

💖 NAME 💖

telescope-identity — manage telescope identities.

Okay so this is the TELESCOPE-IDENTITY(1) page from the General Commands Manual, and it's literally the utility for managing telescope(1) identities. Identities are TLS client certificates used for Gemini — no cap, that's the whole vibe. 💅

✨ SYNOPSIS ✨

telescope-identity command args...

That's the shape of it, bestie: you give it a command, then the args. 🫶

🌸 DESCRIPTION 🌸

telescope-identity is a utility to manage telescope(1) identities. The commands for telescope-identity are as follows:

  • generate [-t type] name — generate a new keypair under the given name. If type is RSA, an RSA key with 4096 bit will be created. By default it's an EC key with secp384r1. 🎀
  • remove name — remove the name identity.
  • import -C cert [-K key] name — imports a certificate as name. -C is the path to the certificate itself. If the key is on a separate file, it needs to be passed with -K.
  • export -C cert name — exports the certificate for the identity name. The certificate and the key will be saved at cert. At the moment, it's not possible to export the certificate and the private key in different files.
  • list — print one per line the available identities. slay, organized. ✨
  • mappings [name] — show on which servers and paths the identities are used. The output consists of the identity name, a tab character, and the hostname, optional port number, and path under which that identity will be loaded by telescope(1).

If name is given, limit the output only to the instances of that identity.

  • use name host[:port][/path] — save a new mapping for the given identity name.
  • forget name host[:port][/path] — remove the mapping for the given identity name.
bestie heads up: export is lowkey doing the most — right now it can't put the certificate and the private key in different files. noted. 💀

🦋 SEE ALSO 🦋

telescope(1) — that's the one. go read it, iykyk. 🌈

👑 AUTHORS 👑

The telescope-identity utility was written by Omar Polo <op@omarpolo.com>. author credit, iconic behavior. 🫶

and that's a wrap, bestie 💖 source/version Debian, dated February 16, 2024 — footer receipts and all. byeeee 🎀

📦 where this page comes from