Knaix CLI is now open source

Private infrastructure,
from your terminal.

One native binary, no runtime to install alongside it. Run the whole stack offline on your own machine with no account at all, or sign in and drive hosted nodes from the same command set.

$ brew install kovalentai/tap/knaix

macOS and Linux. Update with brew upgrade knaix and remove it with brew uninstall knaix. Tab completion is set up for you.

Get Started

Go to Dashboard

knaix - zsh

$ knaix local up
✓ Local node ready on http://127.0.0.1:8080.
$ knaix upload ./docs
  ✓ travel-policy.md ingested (1 chunk), embedded by arctic-embed-s-int8-v1.
✓ Ingested 2 file(s), 2 chunk(s).
$ knaix chat "when are travel receipts due?"
AI: Receipts for air travel reimbursement must be submitted within 30 days of the trip.
$ knaix repl
● Chatting with local. /help lists commands; /exit ends the session.
knaix [local]> /remember the staging cluster lives in us-west-2
✓ Noted. Saved to ~/.knaix/memory/local/_knaix_durable_memory.md and ingested.

From local to mesh

Start on your machine. Grow into the mesh.

Run a private node offline with no account. When you are ready to share or scale, sign in and provision a hosted node you manage from the Kovalent Dashboard.

01Offline

knaix local upRun it locally

The whole stack on your machine: its own store, embedder and reranker. No account, no network, just Docker.

knaix loginSign in when ready

Authenticate through your browser, following whichever control plane the CLI is pointed at. Your local node keeps running.

knaix upProvision a hosted node

Request compute on your account and watch it join the mesh. It shows up in your Kovalent Dashboard, ready to manage.

Go to Dashboard

NewRun knaix local connect and your local node appears in the same Dashboard as your hosted nodes, with its own health, metrics and logs. Local and hosted, side by side.

Workflows

The jobs your terminal should handle.

One native binary for the loop from node provisioning to private agent work.

Provision a node

Authenticate, request compute, and join a private node to your mesh without leaving the terminal.

Open an agent session

Start a persistent REPL for private agent work, fast follow-up questions, and answers grounded in your own documents.

Attach working memory

Save facts with /remember and read them back with knaix memory, so context follows your node without becoming someone else's datastore.

Automate safely

Use JSON output and scoped node credentials for scripts, CI jobs, and repeatable agent workflows.

Commands

The Knaix command suite.

Grouped by what you are trying to do, not by internal subsystem. Every command here exists today; the full reference lists their flags and output modes.

Access

Authenticate and set the node context your shell should use.

knaix loginknaix use

Nodes

Provision compute and inspect the private nodes available to you.

knaix upknaix list

Sessions

Talk to an agent once, or open a persistent interactive REPL.

knaix chatknaix repl

Knowledge

Inspect node memory and ingest local files into private retrieval.

knaix memoryknaix upload

Local

Run the whole stack on your machine with no account, then connect it to your dashboard.

knaix local upknaix local connectknaix selftest

Observability

Check that a node is healthy, and read what it has been doing.

knaix statusknaix logsknaix metrics

Shell

Completions and prompt integration for bash, zsh, and fish.

knaix shellinitknaix completions

View Full Documentation

Private infrastructure,from your terminal.

Start on your machine. Grow into the mesh.

The jobs your terminal should handle.

The Knaix command suite.

Private infrastructure,
from your terminal.