Reference

Command-line client

Manage Agents and inspect Turns, Conversations, and MemorySpaces with the 0.32 nvoken CLI.

Install the released CLI and authenticate:

go install github.com/deepnoodle-ai/nvoken/cmd/nvoken@v0.32.0
nvoken auth login
nvoken auth status

For CI, set NVOKEN_BASE_URL and NVOKEN_API_KEY. Add --json when another program consumes output.

Agents and Turns

nvoken agent create --file support-agent.json
nvoken agent lookup support
 
nvoken turn start \
  --agent-id 019b0a12-a5f6-7ed5-b636-76ea74f399ad \
  --tenant acme \
  --user alice \
  --wait \
  "Summarize this request."
 
nvoken turn get 019b0a13-2c74-7a91-8f3d-5b1e0c6d4a28
nvoken turn result 019b0a13-2c74-7a91-8f3d-5b1e0c6d4a28
nvoken turn list --tenant acme --agent-id 019b0a12-a5f6-7ed5-b636-76ea74f399ad

Agent creation and publication accept exact JSON files so the CLI never hides behavior fields. - reads JSON from standard input.

Continuity and memory

nvoken conversation list --tenant acme
nvoken conversation messages 019b0a13-6e08-7b52-9d41-2af7c9e30b16
nvoken conversation transcript 019b0a13-6e08-7b52-9d41-2af7c9e30b16
 
nvoken memory-space list --tenant acme --scope tenant
nvoken memory-space get 019b0a13-91bd-7c0e-b8a7-43e5d2f10c94

Use nvoken --help and nvoken <group> --help for the full current command surface, including controls, models, usage, credits, admissions, credentials, provider keys, and signing keys.