CLI - CruqAI

Install with pip install cruqai. Authenticate with cruqai login or the CRUQAI_API_KEY / CRUQAI_BASE_URL environment variables.

Agents & runs

Command	Description
`cruqai run <agent> "<text>"`	Run an agent and stream its tool-call trace.
`cruqai runs`	List recent runs.
`cruqai trace <run-id>`	Show a run’s persisted trace.
`cruqai push <file.py>`	Compile an authoring file and publish an agent.
`cruqai dev <file.py> "<text>"`	Run an agent locally, in-process.
`cruqai serve <file.py>`	Expose `@tool` functions over MCP.

Knowledge

Command	Description
`cruqai knowledge list`	List knowledge bases.
`cruqai knowledge create <name>`	Create a knowledge base.
`cruqai knowledge add-doc <kb> --title T --file F`	Ingest a document.
`cruqai knowledge search "<query>"`	Semantic search over chunks.
`cruqai knowledge delete <name>`	Delete a base and its documents.

Memory

Command	Description
`cruqai memory add "<fact>"`	Store a memory.
`cruqai memory search "<query>"`	Recall memories.
`cruqai memory list`	List stored memories.

Guardrails & prompts

Command	Description
`cruqai guardrails apply <name> --kind ...`	Create/update a guardrail.
`cruqai guardrails list`	List guardrails.
`cruqai prompts apply <name> --template ...`	Create/update a prompt.
`cruqai prompts list`	List prompts.

Guardrails & Prompts API Overview

⌘I