┌─────────────┐
       ┌───────────────►│  zxc binary │◄────┬───────────────┐
       │                └┬────────────┘     │               │
       │                 │                  │               │
       │                 │    unix socket   │               │
       │                 │                  │               │
┌──────▼──────┐   ┌──────▼──────┐   ┌───────▼─────┐   ┌─────▼──────┐
│ Interceptor │   │   History   │   │   Repeater  │   │  Addons    │
└─────────────┘   └─────────────┘   └─────────────┘   └────────────┘

attr tmux vim ffuf sqlmap bsdmainutils

mkdir $HOME/.config/zxc
cp ./config/{alias,config.toml,tmux.conf} $HOME/.config/zxc

openssl genrsa -out $HOME/.config/zxc/private.key 2048

openssl req -x509 -new -nodes -key $HOME/.config/zxc/private.key -sha256 -days 1024 -out $HOME/.config/zxc/zxca.crt -extensions v3_req -config ./mkscripts/CA.cnf

mkdir -p $HOME/.vim/plugin
cp ./config/example/zxc.vim $HOME/.vim/plugin

cp -r ./config/example/ftplugin $HOME/.vim

mkdir -p $HOME/.vim/pack/git-plugins/start/
git clone --depth 1 https://github.com/hail-hydrant/zxc.vim $HOME/.vim/pack/git-plugins/start/zxc.vim

For example, to intercept all domains except https://example.com,

The flags also support wildcard. For example, to intercept all sub domains of
http://*.example.com

The domains can be comma separated list of values.

zxc -i example.com:80,example.com:443

Displays intercepted requests and responses. Each request or response is added
as buffer.

Displays the following history files,

• http history (his)
• all websocket history (whis)
• single websocket session history (wsess)

Performs history recording. Closing it halts recording. In case of closing the
window accidentally reopen it by calling vhistory to resume recording. If zxc
is existed without history window, a state file .history.state is created to
resume logging the next time zxc is attached to this session.

Window is non modifiable and read only.

Repeater window is used to repeat requests. The original request is copied to a
folder named r-$id for http and r-ws-$id for websocket within the
specific history folder.

To repeat a websocket request,

1. In a websocket request (wreq) file, call WsSendToRepeater.
2. In repeater window, http request corresponding to the websocket handshake is
   displayed in top-left.
3. Call WsEstablish in the request(req) window to establish a websocket connection.
4. Write the data in scratch.wreq in bottom left and call RepeaterSend to
   send.

Addons window is used to run additional tools. The original request is copied
to a folder named addons/$addon_prefix-$id.req within the specific history
folder with prefix specific to the addon being called. The request is displayed
in the top window and a terminal with addon cmd and arguments is displayed in
bottom split. Currently, ffuf and sqlmap are available.

Refer to for example addon integration.

Define a new table in $HOME/.config/zxc/config.toml file.
The following values(strings) are required:

If the binary by default uses https, skip http_flag and vice versa.

The addon can be called from request .req file by calling RequestToAddon
function

call RequestToAddon("addon_name")

Calling from history .his file, by calling HistoryToAddon function

call HistoryToAddon("addon_name")

Add command or keymap via the ftplugin for req and his.

Example Command
for .req

command RequestToAddon_Name :call RequestToAddon("addon_name")

For .his

command HistoryToAddon_Name :call HistoryToAddon("addon_name")

Example Keymap
for .req

For .his

The following file types are available in zxc.

• Vim fold is used to apply filters. Use zR to open all folds.

• The HistoryIndent command uses the column shell command and can be
  resource intensive on large files. Use sparingly.

• HostScope and UriScope support vim regex. Prefix the entry with /r to
  match as regex. For example to match all subdomains of google.com, /r .*.google.com

For his filetype, the URI can be concealed. Set g:conceal variable in
.his ftplugin to the number of characters to be concealed. Set the
conceallevel in your vimrc to enable this feature.

req filetype has specific set of variables which can be modified to customize
request handling. EditBufVar command can be used to edit buffer variables in
a popup. Save and quit popup to reflect changes. The following variables are
available in interceptor and repeater windows.

The following extended at