How-to guides¶

Task-focused recipes. Each guide assumes you have a tool built on the framework (see App context for the entry-point pattern) and walks one job end to end. For the full API of any crate named here, follow through to its component page.

Commands & errors¶

• Add a custom command — register a subcommand via the Command trait and BUILTIN_COMMANDS.
• Produce user-facing errors — diagnostics with miette instead of bare Result.

Configuration & secrets¶

• Configure credentials — env-var, OS keychain, or literal, and the resolution precedence.
• Configure an AI provider — wire rtb-ai to Claude, OpenAI, Gemini, or Ollama.

Observability¶

• Structured JSON logging — JSON logs
• telemetry events with automatic secret redaction.

Releases¶

• Secure releases & self-update — signed, checksum-verified release artefacts and the update flow.