Skip to main content

CLI Reference

cortex build [NEW]

The primary entry point for setting up your environment. Resolves dependencies, detects system architecture, and prepares the local KV cache.

cortex build

cortex dev

Runs the agent directly from a manifest without bundling first. Use this during development.

cortex dev --config cortex.yaml

cortex bundle

Packages the agent logic, prompt templates, and dependencies into a portable .cortex archive.

cortex bundle --config cortex.yaml --output agent_v1.cortex

cortex run

Executes a .cortex bundle inside the isolated runtime.

cortex run agent_v1.cortex

cortex extract [NEW]

Extracts structured knowledge from unstructured data sources (PDFs, URLs, Logs) and primes the agent's long-term memory.

cortex extract --source ./data/manual.pdf --target memory/alpha

cortex eval [NEW]

Runs the integrated evaluation engine to benchmark agent response quality and latency against a defined test set.

cortex eval --agent researcher --test-set ./tests/baseline.json

cortex list

Lists all active agent processes, their resource usage, and p99 latency metrics.

cortex list

cortex logs

Streams structured log output. Now includes Turbo Mode thread allocation details.

cortex logs assistant --follow

cortex doctor

Runs a system diagnostic. Checks runtime version, architecture support (ARM64/x86_64), and Shared KV Cache health.

cortex doctor

cortex init [DEPRECATED]

Deprecated

cortex init is deprecated as of v2.5.10. Use cortex build to initialize and verify your environment.