Skip to main content
Pass input with flags that match its type, or give the whole input as JSON.

How to pass each kind of input

Give the whole input as JSON

With --input -, expl reads the JSON from standard input.
  • If you give both --input and a flag, the flag wins. The exception is a list: a repeated flag adds its items to the list in the --input JSON. To replace the whole list, change it in the JSON.
  • A generated command rejects an unknown flag or an extra argument (exit code 2) with a suggestion of similar names. The built-in commands (expl status, expl project use, expl lang, expl skill and expl completion) do not report them; see Global flags.
  • Pass an input that has the same name as a global flag, and a string that itself starts with @, in the --input JSON.

An id can be the first argument

A command that needs exactly one id takes it as the first argument. Giving it as a flag, such as --chart-id c789, is the same. When a required id is missing, expl lists the candidates it can find and exits with code 2.