Skip to main content

CLI reference

distri -h
Usage: distri [OPTIONS] [COMMAND]

Commands:
list List available agents
list-tools List available tools
run Run agent in interactive chat mode or execute a single task
serve Start the server (API only by default, use --ui to enable web interface)
toolcall Call a specific tool directly (equivalent to /toolcall slash command)
publish Publish a plugin to the DAP registry
validate-prompt Validate custom agent prompt templates
generate-prompt Generate and print the planning prompt for an agent with a given task
generate-response Generate and stream the LLM response with parsed tool calls (without agent loop execution)
help Print this message or the help of the given subcommand(s)

Options:
-c, --config <CONFIG> Path to the distri.toml configuration file
-v, --verbose Verbose output
--agent <AGENT> Agent name to use (defaults to 'distri')
--input <INPUT> Input data as JSON string or text
-h, --help Print help
-V, --version Print version

Sample execution

distri run search_agent --task "who is the prime minister of singapore"
⏺ Thought for 2.2 seconds

⏺ search({ "query": "current prime minister of Singapore", "limit": 1})
⏺ Thought for 1.3 seconds

⏺ final({ "input": "The current Prime Minister of Singapore is Lawrence Wong, who assumed office in 2024."})
The current Prime Minister of Singapore is Lawrence Wong, who assumed office in 2024.