CLI

Reference documentation for Issu’s CLI

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.