# Argus Database Query Visualizer

> Compact database query visualizer for inspecting event streams, query shells and trace maps.

Page: https://adith.xyz/projects/argus
Author: [Adith Manikonda](https://adith.xyz/about.md) (https://adith.xyz)
Last updated: 2026-10-21

- Built by: Adith Manikonda
- Year: 2025
- Category: CLI & Tools
- Built with: Python, Telemetry, Databases, Query Visualization
- Source code: https://github.com/Ad1th/Argus

## The problem

A query plan printed as text tells you the operators but not where the work actually goes. Reading EXPLAIN output is a skill; seeing the plan is not.

## The approach

A CSV is registered as a DuckDB view through read_csv_auto, so there is no schema step before you can query. The plan is parsed into an operator graph and laid out with Dagre, then rendered as nodes and edges in React Flow, so the shape of the plan is the thing on screen. The backend was moved from Python to Rust on Axum; the Python implementation is kept for reference.

## What it does not do

DuckDB runs in-memory, so every uploaded table is lost when the backend restarts. Fine for reading a plan, not a place to keep data.

## More by Adith Manikonda

- [CaughtIn4K Golang Event Inspector](https://adith.xyz/projects/caughtin4k.md): High-resolution HTTP event capture, local SQLite log recorder, and instant review dashboard.
- [WhoHitMe CLI Traffic Tracer](https://adith.xyz/projects/whohitme.md): CLI utility for quick request tracing, source IP inspection, and request header analysis.
- [WhatDidYouSend Token Microservice](https://adith.xyz/projects/whatdidyousend.md): Token inspection microservice backed by PostgreSQL for payload verification and audit logging.