Divinci CLI

The official command-line interface for Divinci AI. Manage workspaces, chat sessions, knowledge bases, releases, and more — directly from your terminal or CI/CD pipeline.

Package: @divinci-ai/cli · Version: 0.1.0 · Requires: Node.js ≥ 22.14.0

This reference is generated automatically from the CLI source — every command, flag, and argument you see below is guaranteed to match the shipped binary.

Installation

Install globally so the divinci command is available anywhere:

Package manager	Command
npm	`npm install -g @divinci-ai/cli`
pnpm	`pnpm add -g @divinci-ai/cli`
yarn	`yarn global add @divinci-ai/cli`

Or run a one-off command without installing:

npx @divinci-ai/cli auth login

Authentication

Credentials are stored at ~/.config/divinci/credentials.json with 0600 permissions (readable only by your user). Named profiles let you stay authenticated against multiple environments simultaneously.

In CI/CD environments, set DIVINCI_API_KEY instead of running divinci auth login.

Global Options

These flags are available on every command:

Flag	Description	Default
`-V, --version`	output the version number	—
`--api-key <key>`	Override API key	—
`--workspace <id>`	Override workspace ID	—
`--json`	Output as JSON (for scripting)	—
`--no-color`	Disable colored output	—
`--quiet`	Minimal output	—
`--verbose`	Debug output	—
`--profile <name>`	Named profile	`default`
`--api-url <url>`	Override API base URL	—

auth

Authentication management

`divinci auth login`

Authenticate with your Divinci account

Options

Flag	Value	Description	Default
`--profile <name>`	value	Profile name to store credentials under	`default`
`--api-key`	—	Use API key authentication instead of browser login	—
`--no-browser`	—	Print login URL instead of opening browser (for SSH/headless)	—
`--api-url <url>`	value	API URL (determines Auth0 environment)	—

Usage

divinci auth login [options]

Examples

divinci auth login

divinci auth login --profile <value>

`divinci auth logout`

Remove stored credentials

Options

Flag	Value	Description	Default
`--profile <name>`	value	Profile to remove	`default`
`-y, --yes`	—	Skip confirmation	—

Usage

divinci auth logout [options]

Examples

divinci auth logout

divinci auth logout --profile <value>

`divinci auth status`

Show current authentication status

Usage

divinci auth status

Examples

divinci auth status

`divinci auth whoami`

Alias for `auth status`

Usage

divinci auth whoami

Examples

divinci auth whoami

chat

Interactive AI chat or manage conversations

`divinci chat list`

List conversations

Aliases: ls

Options

Flag	Value	Description	Default
`--limit <number>`	value	Maximum results	`20`
`--offset <number>`	value	Offset for pagination	`0`

Usage

divinci chat list [options]

Examples

divinci chat list

divinci chat list --limit <value>

`divinci chat history`

Get conversation history

Arguments

Name	Required	Description
`transcriptId`	Yes

Options

Flag	Value	Description	Default
`--limit <number>`	value	Maximum messages to return	`50`

Usage

divinci chat history <transcriptId> [options]

Examples

divinci chat history <transcriptId>

divinci chat history <transcriptId> --limit <value>

`divinci chat send`

Send a message to a conversation

Arguments

Name	Required	Description
`transcriptId`	Yes
`message`	Yes

Options

Flag	Value	Description	Default
`--stream`	—	Stream the response token-by-token	—

Usage

divinci chat send <transcriptId> <message> [options]

Examples

divinci chat send <transcriptId> <message>

rag

Knowledge base and RAG operations

`divinci rag search`

Search your knowledge base

Arguments

Name	Required	Description
`query`	Yes

Options

Flag	Value	Description	Default
`--limit <number>`	value	Maximum results	`5`

Usage

divinci rag search <query> [options]

Examples

divinci rag search <query>

divinci rag search <query> --limit <value>

`divinci rag files`

List indexed files

Aliases: ls

Options

Flag	Value	Description	Default
`--page <number>`	value	Page number	`1`
`--limit <number>`	value	Results per page	`20`

Usage

divinci rag files [options]

Examples

divinci rag files

divinci rag files --page <value>

`divinci rag status`

Get file processing status

Arguments

Name	Required	Description
`fileId`	Yes

Usage

divinci rag status <fileId>

Examples

divinci rag status <fileId>

`divinci rag upload`

Upload a file to the knowledge base for RAG indexing

Arguments

Name	Required	Description
`file`	Yes

Options

Flag	Value	Description	Default
`--targets <ids>`	value	Comma-separated RAG vector target IDs	—
`--title <title>`	value	Document title	—
`--description <desc>`	value	Document description	—
`--language <lang>`	value	Language hint for audio transcription (e.g. en, es, fr)	—
`--chapter-aware`	—	Prepend section headings to each chunk for structured documents (books, manuals)	—
`--wait`	—	Wait for processing to complete	—
`--poll-interval <seconds>`	value	Polling interval when --wait is used	`10`

Usage

divinci rag upload <file> [options]

Examples

divinci rag upload <file>

divinci rag upload <file> --targets <value>

`divinci rag targets`

Manage RAG vector indexes (upload targets)

Usage

divinci rag targets

Examples

divinci rag targets

`divinci rag reindex`

Re-process a file through the chunking + embedding pipeline

Arguments

Name	Required	Description
`fileId`	Yes

Options

Flag	Value	Description	Default
`--targets <ids>`	value	Comma-separated RAG vector IDs to index into (defaults to file's existing targets)	—
`--chapter-aware`	—	Prepend section headings to each chunk for structured documents (books, manuals)	—
`--wait`	—	Wait for processing to complete	—
`--poll-interval <seconds>`	value	Polling interval when --wait is used	`10`

Usage

divinci rag reindex <fileId> [options]

Examples

divinci rag reindex <fileId>

divinci rag reindex <fileId> --targets <value>

`divinci rag config`

Update retrieval settings for a RAG vector index

Arguments

Name	Required	Description
`collectionId`	Yes

Options

Flag	Value	Description	Default
`--min-score <number>`	value	Minimum similarity score threshold for vector search (0-1, default 0.62)	—
`--context-per-message <number>`	value	Max content chunks returned per query (default 5)	—
`--embedding-model <model>`	value	Embedding model used for indexing and querying	—

Usage

divinci rag config <collectionId> [options]

Examples

divinci rag config <collectionId>

divinci rag config <collectionId> --min-score <value>

`divinci rag groups`

Manage RAG vector groups (merged multi-index retrieval)

Usage

divinci rag groups

Examples

divinci rag groups

release

Release management

`divinci release list`

List releases

Aliases: ls

Options

Flag	Value	Description	Default
`--status <status>`	value	Filter by status (draft, published, archived)	—
`--limit <number>`	value	Maximum results	`20`

Usage

divinci release list [options]

Examples

divinci release list

divinci release list --status <value>

`divinci release get`

Get release details

Arguments

Name	Required	Description
`releaseId`	Yes

Usage

divinci release get <releaseId>

Examples

divinci release get <releaseId>

`divinci release create`

Create a new release

Options

Flag	Value	Description	Default
`--name <name>` required	value	Name for the release	—

Usage

divinci release create [options]

Examples

divinci release create

divinci release create --name <value>

`divinci release update`

Update a release

Arguments

Name	Required	Description
`releaseId`	Yes

Options

Flag	Value	Description	Default
`--name <name>`	value	New release name	—
`--status <status>`	value	New release status	—

Usage

divinci release update <releaseId> [options]

Examples

divinci release update <releaseId>

divinci release update <releaseId> --name <value>

`divinci release delete`

Delete a release

Aliases: rm

Arguments

Name	Required	Description
`releaseId`	Yes

Usage

divinci release delete <releaseId>

Examples

divinci release delete <releaseId>

`divinci release publish`

Publish (activate) a release

Arguments

Name	Required	Description
`releaseId`	Yes

Usage

divinci release publish <releaseId>

Examples

divinci release publish <releaseId>

`divinci release create-from-mcp`

Create a release pre-configured with tools from an MCP server

Options

Flag	Value	Description	Default
`--url <url>` required	value	MCP server URL to discover tools from	—
`--name <name>` required	value	Name for the release	—
`--description <description>`	value	Release description	—

Usage

divinci release create-from-mcp [options]

Examples

divinci release create-from-mcp

divinci release create-from-mcp --url <value>

audio

Audio transcript management

`divinci audio list`

List audio transcripts

Aliases: ls

Options

Flag	Value	Description	Default
`--limit <number>`	value	Maximum results	`20`

Usage

divinci audio list [options]

Examples

divinci audio list

divinci audio list --limit <value>

`divinci audio get`

Get audio transcript details

Arguments

Name	Required	Description
`audioId`	Yes

Usage

divinci audio get <audioId>

Examples

divinci audio get <audioId>

`divinci audio upload-url`

Upload audio from a URL

Arguments

Name	Required	Description
`url`	Yes

Usage

divinci audio upload-url <url>

Examples

divinci audio upload-url <url>

`divinci audio delete`

Delete an audio transcript

Aliases: rm

Arguments

Name	Required	Description
`audioId`	Yes

Usage

divinci audio delete <audioId>

Examples

divinci audio delete <audioId>

`divinci audio generate-rag`

Generate RAG content from an audio transcript

Arguments

Name	Required	Description
`audioId`	Yes

Usage

divinci audio generate-rag <audioId>

Examples

divinci audio generate-rag <audioId>

fine-tune

Fine-tuning management

`divinci fine-tune list`

List fine-tuning jobs

Aliases: ls

Options

Flag	Value	Description	Default
`--limit <number>`	value	Maximum results	`20`

Usage

divinci fine-tune list [options]

Examples

divinci fine-tune list

divinci fine-tune list --limit <value>

`divinci fine-tune get`

Get fine-tuning job details

Arguments

Name	Required	Description
`jobId`	Yes

Usage

divinci fine-tune get <jobId>

Examples

divinci fine-tune get <jobId>

`divinci fine-tune create`

Create a new fine-tuning job

Options

Flag	Value	Description	Default
`--name <name>` required	value	Name for the fine-tuning job	—
`--base-model <model>` required	value	Base model to fine-tune	—

Usage

divinci fine-tune create [options]

Examples

divinci fine-tune create

divinci fine-tune create --name <value>

`divinci fine-tune delete`

Delete a fine-tuning job

Aliases: rm

Arguments

Name	Required	Description
`jobId`	Yes

Usage

divinci fine-tune delete <jobId>

Examples

divinci fine-tune delete <jobId>

`divinci fine-tune start`

Start a fine-tuning job

Arguments

Name	Required	Description
`jobId`	Yes

Usage

divinci fine-tune start <jobId>

Examples

divinci fine-tune start <jobId>

`divinci fine-tune status`

Check fine-tuning job status

Arguments

Name	Required	Description
`jobId`	Yes

Usage

divinci fine-tune status <jobId>

Examples

divinci fine-tune status <jobId>

`divinci fine-tune cancel`

Cancel a running fine-tuning job

Arguments

Name	Required	Description
`jobId`	Yes

Usage

divinci fine-tune cancel <jobId>

Examples

divinci fine-tune cancel <jobId>

config

Workspace configuration

`divinci config get`

Get workspace configuration

Usage

divinci config get

Examples

divinci config get

`divinci config set-title`

Set workspace title

Arguments

Name	Required	Description
`title`	Yes

Usage

divinci config set-title <title>

Examples

divinci config set-title <title>

`divinci config set-description`

Set workspace description

Arguments

Name	Required	Description
`description`	Yes

Usage

divinci config set-description <description>

Examples

divinci config set-description <description>

workspace

Workspace management

Aliases: ws

`divinci workspace list`

List your workspaces

Aliases: ls

Options

Flag	Value	Description	Default
`--limit <number>`	value	Maximum results	`20`

Usage

divinci workspace list [options]

Examples

divinci workspace list

divinci workspace list --limit <value>

`divinci workspace get`

Get workspace details

Arguments

Name	Required	Description
`workspaceId`	Yes

Usage

divinci workspace get <workspaceId>

Examples

divinci workspace get <workspaceId>

`divinci workspace use`

Set default workspace for future commands

Arguments

Name	Required	Description
`workspaceId`	Yes

Usage

divinci workspace use <workspaceId>

Examples

divinci workspace use <workspaceId>

`divinci workspace create`

Create a new workspace

Options

Flag	Value	Description	Default
`--title <title>` required	value	Workspace title	—
`--description <description>` required	value	Workspace description	—

Usage

divinci workspace create [options]

Examples

divinci workspace create

divinci workspace create --title <value>

`divinci workspace update`

Update the active workspace

Options

Flag	Value	Description	Default
`--title <title>`	value	New workspace title	—
`--description <description>`	value	New workspace description	—

Usage

divinci workspace update [options]

Examples

divinci workspace update

divinci workspace update --title <value>

`divinci workspace delete`

Delete the active workspace

Options

Flag	Value	Description	Default
`--force`	—	Skip confirmation prompt	—

Usage

divinci workspace delete [options]

Examples

divinci workspace delete

group

User group management

`divinci group create`

Create a new user group

Options

Flag	Value	Description	Default
`--name <name>` required	value	Group name	—
`--slug <slug>` required	value	URL-safe group slug	—

Usage

divinci group create [options]

Examples

divinci group create

divinci group create --name <value>

`divinci group list`

List your groups

Aliases: ls

Usage

divinci group list

Examples

divinci group list

`divinci group get`

Get group details

Arguments

Name	Required	Description
`groupId`	Yes

Usage

divinci group get <groupId>

Examples

divinci group get <groupId>

`divinci group update`

Update a group

Arguments

Name	Required	Description
`groupId`	Yes

Options

Flag	Value	Description	Default
`--name <name>` required	value	New group name	—

Usage

divinci group update <groupId> [options]

Examples

divinci group update <groupId>

divinci group update <groupId> --name <value>

`divinci group delete`

Delete a group

Arguments

Name	Required	Description
`groupId`	Yes

Usage

divinci group delete <groupId>

Examples

divinci group delete <groupId>

`divinci group invite`

Invite a user to a group

Arguments

Name	Required	Description
`groupId`	Yes

Options

Flag	Value	Description	Default
`--email <email>` required	value	Email address to invite	—

Usage

divinci group invite <groupId> [options]

Examples

divinci group invite <groupId>

divinci group invite <groupId> --email <value>

`divinci group remove-user`

Remove a user from a group

Arguments

Name	Required	Description
`groupId`	Yes

Options

Flag	Value	Description	Default
`--user-id <userId>` required	value	User ID to remove	—

Usage

divinci group remove-user <groupId> [options]

Examples

divinci group remove-user <groupId>

divinci group remove-user <groupId> --user-id <value>

permissions

Permission management

`divinci permissions list`

List permissions for the active workspace

Aliases: ls

Usage

divinci permissions list

Examples

divinci permissions list

`divinci permissions mine`

Show your permissions on the active workspace

Usage

divinci permissions mine

Examples

divinci permissions mine

`divinci permissions grant`

Grant permissions to a user or group

Options

Flag	Value	Description	Default
`--user <email>`	value	User email to grant permissions to	—
`--group <slug>`	value	Group slug to grant permissions to	—
`--permissions <permissions>` required	value	Comma-separated permission list (e.g. rag,config,permission)	—

Usage

divinci permissions grant [options]

Examples

divinci permissions grant

divinci permissions grant --user <value>

`divinci permissions revoke`

Revoke permissions from a user or group

Options

Flag	Value	Description	Default
`--user <email>`	value	User email to revoke permissions from	—
`--user-id <userId>`	value	User ID to revoke permissions from	—
`--group <slug>`	value	Group slug to revoke permissions from	—

Usage

divinci permissions revoke [options]

Examples

divinci permissions revoke

divinci permissions revoke --user <value>

Other commands

Top-level commands that don't belong to a group.

`divinci api`

Make a raw API request

Usage

divinci api <method> <path> [options]