KSP — Kush Secure Protocol

Networking & Diagnostics

Purpose

Open an interactive client session to a remote KSP server with full cryptographic handshake negotiation.

Syntax

Command-line specification

bash / powershell

ksp connect <SERVER_URI> [OPTIONS]

Arguments

Argument	Description
<SERVER_URI>	Target server address (e.g., `127.0.0.1:9876` or `ksp://api.kspprotocol.dev:9876`).

Options & Flags

Option Flag	Description
--insecure	Skip certificate signature verification (use ONLY for local debugging).
--cipher <NAME>	Force specific AEAD cipher: `aes-256-gcm` or `chacha20-poly1305`.
--stream <ID>	Automatically open stream ID upon session establishment.

Example Usage

Example command

ksp connect 127.0.0.1:9876 --cipher chacha20-poly1305

Expected Output

  [+] Initiating TCP connection to 127.0.0.1:9876...
  [+] Sending ClientHello (Random: 0x8A9D... | X25519 Ephemeral Key)
  [+] Received ServerHello + Certificate (Subject: localhost)
  [✔] Certificate verified via local root anchor!
  [✔] Session Established! SessionID: 0x4B9E3A... | Cipher: ChaCha20-Poly1305

ksp-session(0x4B9E)> _

Implementation Notes

Enters an interactive REPL command prompt once authenticated where you can type commands like `open`, `send`, `streams`, or `exit`.

Related CommandsView All 50 Commands →

ksp disconnect

ksp server

ksp ping

CLI Installation Guide· Quick Start Workflow· GitHub Source Repository