bellicose100xp/jiq

What it solves

jiq is an interactive terminal-based tool for querying JSON data using jq syntax. It eliminates the trial-and-error process of writing complex jq filters by providing real-time feedback, schema-aware autocompletion, and AI-assisted query generation.

How it works

The tool acts as an interactive wrapper around the jq processor. It allows users to input JSON from files, stdin, the clipboard, or interactive paste. As the user types a query, jiq executes it in real-time and displays the filtered results in a side-by-side pane. It includes a built-in AI assistant that can be configured to use various LLM providers (Anthropic, OpenAI, Gemini, Bedrock) to suggest query fixes or translate natural language into jq filters.

Who it’s for

Developers, data engineers, and DevOps professionals who frequently work with JSON data and need a way to quickly explore, filter, and extract specific information without manually restarting the command line for every query iteration.

Highlights

• Real-time Execution: Results update instantly as you type your query.
• AI Assistant: Provides query suggestions, error fixes, and natural-language input support via LLM integration.
• Context-Aware Autocomplete: Offers schema-aware field suggestions with type hints and value suggestions for comparisons.
• VIM Keybindings: Full support for VIM motions, operators, and text objects for efficient editing.
• Interactive Navigation: Ability to "zoom" into values, step back, or iterate over arrays directly from the results pane.
• Snippet Library: Save and reuse frequently used jq queries.
• Flexible Input: Supports files, stdin, clipboard, and interactive paste.