# Install jqp with Homebrew, apt, MacPorts, Nix, scoop

TUI playground to experiment and play with jq. Version 0.8.0 via Homebrew; verified 2026-07-25. Also installable with debian: sudo apt install jqp.

## Install

```sh
sudo av install brew:jqp
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install jqp
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install jqp
```

  Evidence: MacPorts ports tree: textproc/jqp/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Debian apt (92%):

```sh
sudo apt install jqp
```

  Evidence: Debian stable package indexes: jqp from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#jqp
```

  Evidence: nixpkgs package indexes: pkgs/by-name/jq/jqp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install extras/jqp
```

  Evidence: Scoop official bucket manifest trees: bucket/jqp.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:jqp
- **Package manager:** Homebrew
- **Version:** 0.8.0
- **Source summary:** TUI playground to experiment and play with jq
- **Homepage:** <https://github.com/noahgorstein/jqp>
- **Repository:** <https://github.com/noahgorstein/jqp>
- **Last updated:** 2026-07-25T20:58:05-04:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- jqp (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.8.0
## Project history and usage

jqp is a terminal user interface for experimenting with jq filters against JSON and NDJSON input. It wraps jq exploration in an interactive Go TUI rather than asking users to iterate only through shell history.

### Project history

The project published v0.1.0 on 2022-09-19. Its README says it uses itchyny's Go implementation of jq, gojq, and its UI stack is built with Bubble Tea, Bubbles, Lip Gloss, Chroma, and clipboard support.

### Adoption history

jqp moved quickly into package-manager channels after its first releases. The README lists Homebrew, MacPorts, Arch AUR, Snap, GitHub release binaries, and source builds. The v0.2.0 release notes included MacPorts documentation, clipboard support, and reverse section cycling; later releases added configuration, themes, cancellation of long-running queries, and input-panel toggling.

### How it is used

Users can pipe JSON into jqp, pass a jq query argument, or load JSON from a file. Inside the TUI, keybindings cycle between query, input, and output panes, run filters, copy queries, save output, hide the input panel, and manage query history.

### Why package nerds care

jqp matters in the jq ecosystem because it packages an exploratory workflow rather than another query language. It reflects the Charmbracelet-era wave of polished Go TUIs that made terminal tools feel closer to small interactive applications.

### Timeline

- 2022: v0.1.0 release on 2022-09-19.
- 2022: v0.3.0 release on 2022-10-02 added configuration, many themes, and query cancellation.
- 2023: v0.4.0 release on 2023-01-07 added command history and Chroma style overrides.
- 2025: v0.8.0 release on 2025-09-28 added a Ctrl-t input-panel toggle.

### Related projects

- jqp is directly tied to jq and gojq, and the README credits jqq as inspiration. Its TUI dependencies connect it to the Bubble Tea, Bubbles, Lip Gloss, and Chroma terminal UI ecosystem.

### Sources

- <https://github.com/itchyny/gojq>
- <https://github.com/jcsalterego/jqq>
- <https://github.com/noahgorstein/jqp>
- <https://github.com/noahgorstein/jqp/releases/tag/v0.1.0>
- <https://github.com/noahgorstein/jqp/releases/tag/v0.2.0>
- <https://github.com/noahgorstein/jqp/releases/tag/v0.3.0>
- <https://github.com/noahgorstein/jqp/releases/tag/v0.4.0>
- <https://github.com/noahgorstein/jqp/releases/tag/v0.8.0>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.jqp.yaml
## Other Package-Manager Records

- Debian apt - jqp - 0.7.0-1+b4: normalized package name match | Debian stable package indexes: jqp from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | TUI playground to experiment with jq (program) | https://github.com/noahgorstein/jqp
- Nix - jqp: normalized package name match | nixpkgs package indexes: pkgs/by-name/jq/jqp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - jqp - 0.5.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: jqp from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | TUI playground to experiment with jq (program) | https://github.com/noahgorstein/jqp
- MacPorts - jqp: normalized package name match | MacPorts ports tree: textproc/jqp/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - extras/jqp: normalized package name match | Scoop official bucket manifest trees: bucket/jqp.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/jqp.yml](https://github.com/mxcl/pkgdb/blob/main/combined/jqp.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
