bottleQuery

bottleQuery is a small terminal UI for exploring JSON files with fast path-based queries and autocomplete.

It opens a JSON file from the current directory, then lets you inspect values with expressions like bq.user.name or bq.items[0].price.

Requirements

• Go 1.24+
• One or more .json files in the project root

Run

go run .

Build a binary:

go build -o bottleQuery .
./bottleQuery

How It Works

1. Launch the app.
2. Select a JSON file from the file picker.
3. Query the loaded document using the bq prefix.

Only .json files in the current directory are listed.

Query Examples

bq
bq.user
bq.user.name
bq.items[0]
bq.items[0].price
$tree
help
quit

Controls

File Picker

• ↑ / ↓: move through files
• Tab: autocomplete file name
• Enter: open selected file
• Esc: quit

Query Mode

• Tab: autocomplete keys and indexes
• Enter: run query
• ↑ / ↓: browse query history
• Ctrl+D: return to file picker
• Esc: quit

Notes

• bq returns the full JSON document.
• Array access uses bracket notation, for example bq.results[2].
• $tree prints a readable structure of the loaded JSON.
• help shows the built-in usage summary inside the app.