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 (alias to distri-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

Publishing Agents​

List published agents​

distri agents list

Lists all agents that have been published to the Distri registry.

Publish an agent​

distri agents push <agent_name>

Publishes an agent to the Distri registry. The agent must be defined in your project directory (typically in an agent.md file).

Example:

distri agents push maps_agent

Running the Server​

The distri serve command is an alias for distri-server. It starts the Distri server which exposes REST and WebSocket APIs.

distri serve --project ./agents --port 8787

Options:

  • --project <PATH> - Path to the directory containing your agent definitions
  • --port <PORT> - Port to run the server on (default: 8787)
  • --ui - Enable the web interface (optional)

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.