Examples

Practical patterns for using Knaix in your daily workflow.

1. Multi-Node Heartbeat Check

Verify all your provisioned nodes are healthy before starting a large batch job.

$ knaix ls
Your Kovalent Nodes:
agent-prod-1 [i-0abc123] ... running
agent-prod-2 [i-0def456] ... running
$ knaix metrics agent-prod-1
Fetching metrics for agent-prod-1...
Status: HEALTHY
Latency: 42ms

2. Knowledge Ingestion Flow

Upload a local research paper and immediately enter an immersive REPL session to query it.

$ knaix upload ./research/quantum-computing.pdf
Uploading quantum-computing.pdf (2.4 MB)
  [===================>---------] 1.2MB/2.4MB (12MB/s)
 Done! quantum-computing.pdf uploaded successfully.
$ knaix repl
[Knaix] AI Session: agent-prod-1 (Type /exit to end)
knaix [agent-prod-1]> /summarize the key findings
Thinking... (busy)
AI: The paper presents three major findings regarding qubit stability...

3. Debugging with System Logs

Tailing the logs to see how your node is handling requests in real-time.

$ knaix logs agent-prod-1 --lines 20
Streaming logs for agent-prod-1 (last 20 lines)...
--- Log Start ---
[2026-02-14 15:42:01] INFO: Received chat request
[2026-02-14 15:42:02] DEBUG: Querying local vector store
[2026-02-14 15:42:05] INFO: Generated response (142 tokens)
--- Log End ---

Pro Tip: Shell Aliases

Add alias k=knaix to your .zshrc or .bashrc for even faster orchestration. Commands like k ls and k chat will save you hundreds of keystrokes.