Back to Wuzz

wuzz

README.md

0.5.03.3 KB
Original Source

wuzz

Interactive cli tool for HTTP inspection.

Wuzz command line arguments are similar to cURL's arguments, so it can be used to inspect/modify requests copied from the browser's network inspector with the "copy as cURL" feature.

Installation and usage

GO

$ go get github.com/asciimoo/wuzz
$ "$GOPATH/bin/wuzz" --help

Note: golang >= 1.10 required.

Binary releases are also available.

Apt

$ apt install wuzz

Apk

$ apk add wuzz

Scoop

$ scoop bucket add main
$ scoop install main/wuzz

X-CMD

$ x env use wuzz

Nix

$ nix-shell -p wuzz

Configuration

It is possible to override default settings in a configuration file. The default location is "$XDG_CONFIG_HOME/wuzz/config.toml"on linux and ~/.wuzz/config.toml on other platforms. -c/--config switches can be used to load config file from custom location.

See example configuration for more details.

Commands

KeybindingDescription
<kbd>F1</kbd>Display help
<kbd>Ctrl+R</kbd>Send request
<kbd>Ret</kbd>Send request (only from URL view)
<kbd>Ctrl+S</kbd>Save response
<kbd>Ctrl+E</kbd>Save request
<kbd>Ctrl+F</kbd>Load request
<kbd>Ctrl+C</kbd>Quit
<kbd>Ctrl+K</kbd>, <kbd>Shift+Tab</kbd>Previous view
<kbd>Ctlr+J</kbd>, <kbd>Tab</kbd>Next view
<kbd>Ctlr+T</kbd>Toggle context specific search
<kbd>Ctrl+L</kbd>Clear all tabs to default
<kbd>Alt+H</kbd>Toggle history
<kbd>Down</kbd>Move down one view line
<kbd>Up</kbd>Move up one view line
<kbd>Page down</kbd>Move down one view page
<kbd>Page up</kbd>Move up one view page
<kbd>F2</kbd>Jump to URL
<kbd>F3</kbd>Jump to query parameters
<kbd>F4</kbd>Jump to HTTP method
<kbd>F5</kbd>Jump to request body
<kbd>F6</kbd>Jump to headers
<kbd>F7</kbd>Jump to search
<kbd>F8</kbd>Jump to response headers
<kbd>F9</kbd>Jump to response body
<kbd>F11</kbd>Redirects Restriction Mode

Wuzz accepts regular expressions by default to filter response body. Custom query syntax can be toggled by pressing <kbd>Ctrl+T</kbd>. The following formats have context specific search syntax:

Response formatQuery syntax
HTMLhttps://github.com/PuerkitoBio/goquery
JSONhttps://github.com/tidwall/gjson

TODO

  • Better navigation
  • Autocompletion
  • Tests

Bugs / Suggestions

Bugs or suggestions? Visit the issue tracker or join #wuzz on freenode