Dust CLI

Installation

Install the Dust CLI globally via npm:

npm install -g @dust-tt/dust-cli

Linux

The CLI depends on keytar for storing credentials. On Linux, keytar requires libsecret:

Debian / Ubuntu: sudo apt-get install libsecret-1-dev
Red Hat-based: sudo yum install libsecret-devel
Arch Linux: sudo pacman -S libsecret

Usage

dust [command] [options]

When no command is provided, the chat command runs by default, opening an interactive chat with @Dust with access to your local filesystem.

Available commands

Authenticate with your Dust account.

dust login
dust login --force    # Force re-authentication even if already logged in

`status`

Check your current authentication status.

dust status

`logout`

Log out from your Dust account.

dust logout

`chat`

Chat with a Dust agent. This is the default command: running dust with no arguments opens an interactive chat session.

dust chat
dust              # equivalent

Flags:

Flag	Short	Description
`--sId <sId>`	`-s`	Select an agent by its sId (system identifier).
`--agent <name>`	`-a`	Select an agent by name (e.g. `--agent "My Agent"`).
`--auto`		Automatically accept all file edit operations without prompting.
`--message <text>`	`-m`	Send a single message in non-interactive mode and return a JSON response to stdout.
`--conversationId <id>`	`-c`	Continue an existing conversation (non-interactive mode only).

Examples:

# Interactive: pick an agent by name
dust chat --agent "My Agent"

# Non-interactive: single message, JSON response on stdout
dust chat --agent "My Agent" --message "Summarize Q4 metrics"

# Non-interactive: continue an existing conversation
dust chat -a "My Agent" -m "Add a bullet for next steps" -c <conversationId>

Billing note: Interactive CLI chat (typing in the terminal UI) counts as regular human usage. Non-interactive messages (--message) count as programmatic usage and consume credits.

`skill:init`

Set up a Claude Code / Anthropic skill on your local coding agent (Claude Code, Codex, etc.) that teaches it how to use the Dust CLI to talk to Dust agents.

dust skill:init

Running this scaffolds a SKILL.md in the appropriate .claude/skills/ directory. Once installed, your coding agent gains a skill explaining how to call Dust agents non-interactively (e.g. dust chat -a <agent> -m "..."), making it easy to pull context from Dust, post Slack messages, read Notion pages, and more, all from within your coding workflow.

For more on how Dust Skills relate to Anthropic/Claude Skills, see the Skills documentation and the Anthropic skills repository.

`cache:clear`

Clear the local CLI cache used for faster startup.

dust cache:clear

`help`

Display help information.

dust help

In-chat commands

While in an interactive chat session, type these with a forward slash:

Command	Description
`/exit`	Exit the chat session.
`/switch`	Switch to a different agent.
`/resume`	Resume a previous conversation.
`/attach`	Open a file selector to attach a local file.
`/clear-files`	Clear any attached files.
`/auto`	Toggle auto-approval of file edits on/off (also available via Shift+Tab).

Global options

Flag	Description
`-v`, `--version`	Display the installed CLI version.
`--help`	Display help information for any command.

Headless authentication

If you can’t sign in through a browser, you can sign in with an API key instead. Run dust login with your API key and workspace ID:

dust login --key sk-your_api_key_here --workspaceId ws_abc123

You can also set environment variables, then run dust login:

export DUST_API_KEY="sk-your_api_key_here"
export DUST_WORKSPACE_ID="ws_abc123"

dust login

Parameter	Env variable	CLI flag	Description
API key	`DUST_API_KEY`	`--key`	Your API key for authentication.
Workspace ID	`DUST_WORKSPACE_ID`	`--workspaceId`	Your workspace ID.

Only dust login reads these flags and environment variables. Other commands, such as dust chat, use the credentials that dust login saved. Command-line flags take precedence over environment variables.

What works with an API key

After signing in with an API key, interactive dust chat works. Commands that need your user profile return an authentication error, including non-interactive messages (dust chat --message) and dust status. To use them, sign in with dust login without an API key.

Security considerations

Prefer environment variables over CLI flags; flags may be visible in process listings.
Store API keys securely; avoid committing them to version control.
Use .env files locally and proper secrets management in CI/CD.

Latest Updates

Use cases

Agents

Skills

Capabilities

Pods

Admins

Developers

Deprecated

Installation

Linux

Usage

Available commands

`status`

`logout`

`chat`

`skill:init`

`cache:clear`

`help`

In-chat commands

Global options

Headless authentication

What works with an API key

Security considerations

​Installation

​Linux

​Usage

​Available commands

​login

​status

​logout

​chat

​skill:init

​cache:clear

​help

​In-chat commands

​Global options

​Headless authentication

​What works with an API key

​Security considerations

Installation

Linux

Usage

Available commands

`login`

`status`

`logout`

`chat`

`skill:init`

`cache:clear`

`help`

In-chat commands

Global options

Headless authentication

What works with an API key

Security considerations