Command Reference

Initiates SSO login via the Kovalent Identity Center. Opens your default browser to authenticate, then stores the JWT token and username locally in ~/.knaix/config.json. A local callback server is spawned on port 4242 to receive the auth response.

Displays your current authentication state, default node context, and API endpoint. This command reads from your local ~/.knaix/config.json, which is protected with 0o600 permissions.

Set a default node context for subsequent commands. This allows you to omit the <node-id> argument in other commands. Knaix will persist this to your config using the atomic-save pattern.

Lists all AI nodes provisioned in your account. For each node, displays status, private IP, and the active model. Also supports listing documents within a specific node's knowledge base.

Launches an immersive, continuous AI session. Features include persistent history, multi-line support, and rich Markdown rendering for agent responses.

Send a single message to a node. If no node ID is specified, Knaix features 'Smart Failover' - it will automatically trigger the selection menu if your default node is unreachable.

View files stored in your Sovereign Agentic Memory local isolated directory. If run without a file argument, the command lists all tracked memory files for the node. If given a file name, it reads the memory file and elegantly renders the markdown into your terminal.

Upload a local file to a node's document storage for RAG. Includes real-time byte-rate tracking and ETA progress bars.

Retrieve real-time health and performance metrics for a specific node. Shows the node's health status (HEALTHY/UNHEALTHY), response latency in milliseconds, and the last health check timestamp.

Stream application logs from a private node. Fetches the last N lines from the node's system log endpoint through the private proxy. Useful for debugging agent behavior and monitoring request flow.