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. Shows the logged-in username and configured API endpoint. This command reads from local config only — no network request is made.

Manage CLI configuration settings. Use this to switch between API environments (e.g. local vs production) or reset configuration to defaults.

Lists all AI nodes provisioned in your account. For each node, displays the friendly name, instance ID, current status, private Tailscale IP, and the active model. Alias: ls.

Set a default node context for subsequent commands. This allows you to omit the <node-id> argument in other commands like chat, upload, logs, etc.

Send a message to a specific node. If no node ID is specified, it will use your default set via 'use' or automatically select your only running node.

Upload a local file to a node's persistent document storage. If no node ID is specified, it checks for a default or a single available node.

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.