# Commands
Commands are the mechanism that allows users to actively interact with addons.
Perhaps the most prominent example of this is the mitmproxy console user
interface - every interaction in this tool consists of commands bound to keys.
Commands also form a flexible and very powerful way to interact with mitmproxy
from the command prompt. In mitmproxy console you can enter the command prompt
with the :
key. The prompt has intelligent tab completion for command names
and many of the built-in argument types - give it a try.
The canonical reference for commands is the --commands
flag, which is exposed
by each of the mitmproxy tools. Passing this flag will dump an annotated list of
all registered commands, their arguments and their return values to screen. In
mitmproxy console you can also view a palette of all commands in the command
browser (by default accessible with the C
key binding).
# Working with Flows
Many of mitmproxy’s commands take flows as arguments. For instance, the signature for the client replay commands looks like this:
replay.client [flow]
That means that it expects a sequence of one or more flows. This is where flow specifications come in - mitmproxy will intelligently expand a flexible flow selection language to a list of flows when invoking commands.
Fire up mitmproxy console, and intercept some traffic so we have flows to work with. Now type the following command:
:replay.client @focus
Make sure you try using tab completion for the command name and the flow
specification. The @focus
specifiers expands to the currently focused flow, so
you should see this flow replay. However, replay can take any number of flows.
Try the following command:
:replay.client @all
Now you should see all flows replay one by one. We have the full power of the mitmproxy filter language at our disposal here, so we could also, for example, just replay flows for a specific domain:
:replay.client "~d google.com"
# Custom Key Bindings
Mitmproxy’s key bindings can be customized to your needs in the
~/.mitmproxy/keys.yaml
file. This file consists of a sequence of maps, with
the following keys:
key
(mandatory): The key to bind.cmd
(mandatory): The command to execute when the key is pressed.context
: A list of contexts in which the key should be bound. By default this is global (i.e. the key is bound everywhere). Valid contexts arechooser
,commands
,dataviewer
,eventlog
,flowlist
,flowview
,global
,grideditor
,help
,keybindings
,options
.help
: A help string for the binding which will be shown in the key binding browser.
# Example
-
# Simple global binding
key: ctrl a
cmd: replay.client @marked
-
# Bind key only in the flowlist
# Note that 1 is quoted, or YAML interprets it as a digit
key: "1"
ctx: ["flowlist"]
cmd: console.nav.down
help: Go to next flow