CLI
Categories:
Arguments
Arguments must be entered before commands.
-c [path]
Path to the JSON/Jsonnet configuration file.
-f [format]
Set log format (human, kv, raw, default: human).
-l [level]
Set minimum log level (none, debug, info, error, default: info).
-p
Disable paging via less.
-s [status]
Set the minimum status for error message logging.
-x [key=value]
Set config key=value (can be provided multiple times).
Commands
Issu comes with a list of default Commands, but you can add custom Commands using Macros–Command templates that live within the Issu configuration.
Commands also support partial matching. Issu will attempt to match a partial CLI command (like cfg
) to the longest matching command or macro (in this instance, config
).
add
Create a new issue, optionally specifying labels to include with it.
after
Move an issue’s priority after another issue’s priority.
autocomplete
Adds autocomplete for Issu commands into your terminal:
$ source <(issu autocomplete)
before
Move an issue’s priority before another issue’s priority.
config
Show the rendered config from all sources (file, environment variables, and command line arguments).
del
Delete issues matching a filter.
docs
Open a web browser to the documentation website (this website).
edit
Interactively edit issues matching a filter
eula
View the Issu End User License Agreement (EULA).
jq
Query JSON from stdin using jq. Supports standard JQ filters, and the -r
flag to render raw values.
label
List all known labels.
lint
Lint issues and exit if errors are found. Useful for CI/CD pipelines.
list
List issues as a table or a JSON array.
org
Organize issues by adding default labels and normalizing positions.
pom
Start a Pomodoro timer and track the time against an issue.
set
Set a label and value for issues that match a filter.
version
Print the current version of Issu.