Skip to content

CLI Commands

CommandDescription
duumbi init <name>Create a new DUUMBI workspace
duumbi buildCompile graph modules to a native binary
duumbi checkValidate graph structure and types without building
duumbi describePrint a human-readable program description
duumbi runBuild and execute in one step
duumbi upgradeMigrate an older workspace to the current format

Provider setup is the user-facing entry point for AI-backed Query, Agent, and Intent flows.

CommandDescription
duumbi provider listList configured providers
duumbi provider addAdd and verify a provider configuration
duumbi provider remove <name>Remove a provider configuration
duumbi provider set <name>Update provider configuration

Model selection is handled internally by DUUMBI’s catalog and routing policy. The /model surface is compatibility-oriented; prefer /provider for setup.

CommandDescription
duumbiStart the interactive REPL/TUI in a workspace
/query "<question>"Ask a read-only question without changing mode
/ask "<question>"Alias for one-shot Query
/mode querySwitch to read-only Query mode
/mode agentSwitch to Agent mode for bounded graph mutation
/mode intentSwitch to Intent mode for planned work
/agent "<request>"Run a one-shot Agent mutation from another mode
/intent create "<description>"Create an intent from a natural-language request
duumbi add "<request>"Compatibility command for AI-assisted graph mutation
duumbi undoRevert the last AI mutation snapshot
CommandDescription
duumbi intent create "<description>"Generate an intent spec from a description
duumbi intent review [name]Review intent details; use --edit to modify
duumbi intent execute <name>Execute an intent through decompose, mutate, and verify
duumbi intent status [name]Show intent execution status
CommandDescription
duumbi deps install [--frozen]Resolve and download dependencies
duumbi deps add <@scope/name[@ver]> [--registry R]Add a registry dependency
duumbi deps update [name]Update to latest compatible versions
duumbi deps vendor [--all] [--include "pattern"]Copy dependencies to vendor/
duumbi deps auditVerify lockfile integrity
duumbi deps tree [--depth N]Display dependency tree
CommandDescription
duumbi search <query>Search modules in registries
duumbi publish [--registry R] [--dry-run] [-y]Package and upload a module
duumbi yank <@scope/name@version> [--registry R] [-y]Mark a version as yanked
duumbi registry add <name> <url>Add a registry endpoint
duumbi registry listList configured registries
duumbi registry remove <name>Remove a registry
duumbi registry default <name>Set the default registry
duumbi registry login <name>Authenticate with a registry
duumbi registry logout <name>Remove stored registry credentials
CommandDescription
duumbi mcpStart the MCP server over stdio
duumbi studio [--port N]Launch DUUMBI Studio web UI
duumbi benchmark [--showcase S]Run benchmark showcases

Start the interactive REPL by running duumbi with no arguments in a project directory. Query is read-only by default; Agent and Intent are explicit write-capable modes. See Query Mode for the mode contract.