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.