DirQ ("Direct Query") is an agent-based platform for querying and managing large Windows/Linux fleets. Agents form a peer-to-peer relay mesh and report data back to a central server. The server acts as an Ansible Automation Platform (AAP) inventory source, exposes collected data as structured facts, and can route Ansible execution through the mesh as an alternative to SSH/WinRM connectivity.

• Query the fleet like a dataset instead of logging into hosts one by one
• Keep managed hosts outbound-only instead of opening SSH/WinRM inbound
• Reuse Ansible while replacing the transport underneath
• Build Ansible inventories from live DirQ query results instead of static host lists
• Scale with a relay tree so the server never needs a direct session to every node
• Scan for CVEs in real time — identify every affected host in seconds
• Run ad-hoc commands across the fleet — parallel exec with streaming results

Full documentation lives at atgreen.github.io/dirq.

The docs follow the Diátaxis framework:

DirQ publishes signed RPM and DEB packages for Linux, and signed MSI/EXE installers for Windows — see the install guide for the full server + CLI + agent path. In short:

# Fedora / RHEL / AlmaLinux
sudo tee /etc/yum.repos.d/dirq.repo <<'EOF'
[dirq]
name=DirQ
baseurl=https://atgreen.github.io/dirq/rpm-repo
gpgcheck=1
gpgkey=https://atgreen.github.io/dirq/rpm-repo/RPM-GPG-KEY-dirq
enabled=1
EOF
sudo dnf install dirq-agent

On Windows, download dirq-agent-<version>.msi (or the -setup.exe installer, or the standalone dirq-agent-windows-amd64.exe) from the latest release.

# All binaries
go build -o bin/dirq-server ./cmd/dirq-server
go build -o bin/dirq-agent  ./cmd/dirq-agent
go build -o bin/dirq         ./cmd/dirq

# Windows agent
GOOS=windows GOARCH=amd64 go build -o bin/dirq-agent.exe ./cmd/dirq-agent

# Tests
go test ./...

# Container images
podman build --target server -t dirq-server .
podman build --target agent  -t dirq-agent .

The docs are MkDocs with the Material theme. Sources are in docs/:

pip install mkdocs-material
mkdocs serve     # live preview at http://127.0.0.1:8000
mkdocs build     # render to site/

cmd/
  dirq-server/            Server entrypoint
  dirq-agent/             Agent entrypoint (Windows Service support)
  dirq/                   CLI entrypoint
proto/dirq/v1/            Protobuf definitions
internal/
  server/                 gRPC, REST API, query dispatch, exec routing
  agent/                  Registration, relay mesh, query execution, exec
  query/                  DirQ DSL parser and evaluator
  modules/                System data collectors
  db/                     SQLite + PostgreSQL backends and data access
  tlsutil/                TLS configuration, cert generation
  signutil/               Message signing (Ed25519)
collection/atgreen/dirq/  Ansible collection for AAP
ansible/                  Standalone plugins for CLI Ansible
docs/                     Documentation sources (MkDocs)
Containerfile             Multi-stage build

To report a vulnerability, see SECURITY.md. For the security model (mTLS, message signing, agent-side policy), see the Security model docs.

MIT License. Copyright (c) 2026 Anthony Green. See LICENSE for details.