quelch 0.3.1

Ingest data from Jira, Confluence, and more directly into Azure AI Search
Documentation

What is Quelch?

Quelch is a Rust CLI tool that ingests data from external sources (Jira, Confluence) directly into Azure AI Search indexes — no intermediate storage like Blob Storage or Cosmos DB. It runs as a one-shot sync or a continuous background process, with incremental sync, smart concurrency, and a rich terminal UI.

The name "Quelch" evokes quenching a search index's thirst for data.

Features

  • Direct ingest — Source data goes straight into Azure AI Search indexes
  • Incremental sync — Only fetches changes since last sync using high-water marks
  • Crash-safe — State persisted after every batch; restart and pick up where you left off
  • Smart concurrency — Parallel sync across servers, throttled per credential
  • Rich TUI — Live dashboard showing sync status, rates, and logs (via Ratatui)
  • Multiple sources — Jira and Confluence connectors, with a clean trait for adding more
  • Minimal config — Get started with a 10-line YAML file; smart defaults everywhere

Installation

Homebrew (macOS/Linux)

brew install mklab-se/tap/quelch

Cargo

cargo install quelch

Binary download

Download pre-built binaries from the latest release.

Quick Start

# Generate a starter config
quelch init

# Edit quelch.yaml with your sources and Azure endpoint
# Then run a one-shot sync
quelch sync

# Or run continuous sync
quelch watch

Usage

quelch — Ingest data directly into Azure AI Search

COMMANDS:
    sync        Run a one-shot sync of all configured sources
    watch       Run continuous sync (polls at configured interval)
    status      Show sync status for all sources
    reset       Reset sync state (force full re-sync on next run)
    validate    Validate config file without running
    init        Generate a starter quelch.yaml config

OPTIONS:
    -c, --config <PATH>    Config file path (default: quelch.yaml)
    -v, --verbose          Increase verbosity
    -q, --quiet            Suppress TUI, only log errors
    --json                 Output logs as JSON
    --version              Print version
    --help                 Print help

License

MIT