Getting Started

This guide will walk you through your first 5 minutes with the Knaix CLI.

Authenticate

Initialize your session and join the mesh.

Set Context

Choose a default node for your commands.

Interactive Chat

Send your first private intelligence request.

Step 1: Authenticate

Run the login command. This will open your default browser to the Kovalent Identity Center.

knaix login

After logging in, you can verify your status at any time:

knaix status

Step 2: Set Context

First, list your available AI nodes to find the one you want to use:

knaix ls

Then, set your default node context. This saves you from having to specify the --node-id in every command.

knaix use <node-id>

Step 3: Enter the Flow (REPL)

The most powerful way to interact with your nodes is via the Immersive REPL. This launches a persistent session with command history and Markdown rendering:

knaix repl

Your session is secured via the Sovereign Mesh, ensuring all intelligence data stays private and encrypted.

You're all set!

You've successfully mastered the basics. Explore the full command reference for advanced features like document uploads, metrics, and logs.

Explore Commands