KAPLA-PEER-CONNECT(1)

📦 version 0.4.0, in nixpkgs unstable

💖 kapla-peer-connect(1) — the connect-to-a-peer glow-up ✨

okay so bestie, you want to slide into a peer's DMs? literally same. this is the kapla peer connect page from the Kapla manual and it's giving "let's make a connection" main character energy 🫶

🌸 NAME 🌸

kapla-peer-connect — connect to a peer. that's it, that's the vibe. 💅

✨ SYNOPSIS ✨

kapla peer connect [--control=CONTROL_SOCKET] [OPTION]… PEER_ID

so the whole mission here? attempt to connect to a peer — either by URI or by name. either works, no cap. 🔥

🎀 ARGUMENTS 🎀

  • PEER_ID (required) — the name or URI of the peer you're trying to connect to. yeah it's required, so don't ghost this one bestie, you literally cannot skip it 🙈

💅 OPTIONS 💅

  • -c CONTROL_SOCKET, --control=CONTROL_SOCKET — the Kapla control socket. if you don't pass it, it's absent, and then it goes looking here, in this exact order:
    • $XDG_STATE_HOME/kapla/kapla.sock
    • $HOME/.local/state/kapla/kapla.sock
    • /var/lib/kapla/kapla.sock

🌈 COMMON OPTIONS 🌈

  • --color=WHEN (absent=auto) — colorize the output, because plain text is lowkey sad. WHEN must be one of auto, always or never. one of those three, no improvising ✨
  • --help[=FMT] (default=auto) — show this help in format FMT. the value of FMT must be one of auto, pager, groff or plain. with auto, the format ends up being pager or plain whenever the TERM env var is dumb or undefined. iykyk 🧚
  • -q, --quiet — be quiet. like, fully. it takes over -v and --verbosity, so it wins the argument, periodt 💀
  • -v, --verbose — increase verbosity. repeatable! but highkey, more than twice does not bring more. so don't spam it thinking you'll unlock secret levels, it's not giving that 🌸
  • --verbosity=LEVEL (absent=warning or KAPLA_LOG_LEVEL env) — be more or less verbose. LEVEL must be one of quiet, error, warning, info or debug. takes over -v, so it's the boss of that flag 👑
  • --version — show version information. iconic and short ⭐

🦋 EXIT STATUS 🦋

kapla peer connect exits with:

  • 0 — on success 🎉
  • 123 — on indiscriminate errors reported on standard error
  • 124 — on command line parsing errors
  • 125 — on unexpected internal errors (bugs) 😭

💜 ENVIRONMENT 💜

these environment variables affect the execution of kapla peer connect:

  • KAPLA_LOG_LEVEL — set the log level

🔥 SEE ALSO 🔥

okay bestie, that's the whole page, you're officially peer-connect literate now 💖 slay. this was Kapla 0.4.0, dated KAPLA-PEER-CONNECT(1) 🌟

📦 where this page comes from