Skip to content

CLI.md

Latest commit

 

History

History
137 lines (87 loc) · 3.52 KB

CLI.md

File metadata and controls

137 lines (87 loc) · 3.52 KB
Raw

det-cli

det-cli is the command-line interface for Dash Evo Tool. Run wallet and platform commands from the terminal — no GUI needed.

Build

cargo build --features cli

Quick start

# List available commands
det-cli

# List wallets
det-cli core-wallets-list

# Generate a receive address
det-cli core-address-create wallet-id=savings

Run det-cli --help to see all available commands with descriptions.

Configuration

det-cli reads the app's .env file automatically — the same file used by the GUI. No separate configuration needed.

Config precedence (highest to lowest):

  1. CLI flags (--addr)
  2. Shell environment variables (MCP_API_KEY, MCP_LISTEN)
  3. App's .env file (loaded from the platform data directory)

Connection modes

Standalone (default)

When no MCP_API_KEY is set, det-cli runs its own backend in-process. No running GUI app or server required.

Connected to Dash Evo Tool GUI

Set MCP_API_KEY (in .env or shell) to connect to a running Dash Evo Tool instance instead. This shares the app's live state — wallets, network, database.

The GUI address defaults to http://127.0.0.1:9527/mcp. Override with --addr:

det-cli --addr http://127.0.0.1:9000/mcp core-wallets-list

Force standalone mode with --standalone even when an API key is present.

Usage

Commands use hyphens (core-wallets-list, not core_wallets_list). Parameters are passed as key=value pairs:

det-cli <command> [key=value ...]

Values are parsed as JSON first, falling back to plain strings. Exit code is non-zero on error.

serve — MCP stdio server

det-cli serve

Runs an MCP server over stdin/stdout for Claude Desktop, Claude Code, AI agents, or other MCP clients. See MCP.md for client configuration.

headless — HTTP MCP server daemon

det-cli headless

Runs the HTTP MCP server without a GUI. Requires MCP_API_KEY to be set. Useful for server environments or automated pipelines. Requires the headless feature: cargo build --features headless.

tools — refresh command list

det-cli tools

Fetches and displays all available commands. The list is cached automatically.

completion <shell> — shell completion

det-cli completion bash
det-cli completion zsh

Shell completion

Bash completion is installed automatically on first run to ~/.local/share/bash-completion/completions/det-cli. It works on the next shell session — no manual setup needed. Requires jq for dynamic command name completion.

For zsh:

det-cli completion zsh > "${fpath[1]}/_det-cli"

Examples

# List wallets (standalone, no server needed)
det-cli core-wallets-list

# Generate a receive address
det-cli core-address-create wallet-id=savings

# Show active network and available networks
det-cli network-info

# Check wallet balance
det-cli core-balances-get wallet-id=savings

# Fetch platform address balances (credits and nonces)
det-cli platform-addresses-list wallet-id=savings

# Query Platform withdrawals currently in queue
det-cli platform-withdrawals-get

# Query recently completed withdrawals
det-cli platform-withdrawals-get status=completed

# Get full schema and description for a tool
det-cli tool-describe name=core_funds_send

# Send 0.01 DASH (1,000,000 duffs) to an address (network is required)
det-cli core-funds-send wallet-id=savings address=yXyz... amount-duffs=1000000 network=testnet

# Run as stdio MCP server for Claude Desktop or Claude Code
det-cli serve