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 start questioning it via the CLI.

$ knaix upload agent-prod-1 ./research/quantum-computing.pdf
Uploading quantum-computing.pdf...
File uploaded successfully!
$ knaix chat agent-prod-1 "Summarize the key findings in the uploaded PDF"
Thinking...
Agent: 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.