Usage
Commands
Development

Usage

Every run of the CLI will check to see if all required configuration is in place.

$ npm install -g @tru_id/cli
$ tru COMMAND
running command...
$ tru (--version)
@tru_id/cli/1.2.2 darwin-arm64 node-v18.12.1
$ tru --help [COMMAND]
USAGE
  $ tru COMMAND
...

Commands

tru analytics:pck:daily
tru analytics:pck:hourly
tru analytics:pck:monthly
tru analytics:sck:daily
tru analytics:sck:hourly
tru analytics:sck:monthly
tru analytics:suk:daily
tru analytics:suk:hourly
tru analytics:suk:monthly
tru coverage:country CODE
tru coverage:reach DEVICE-IP
tru help [COMMAND]
tru login IDP
tru oauth2:token
tru phonechecks:create [PHONE_NUMBER]
tru phonechecks:list [CHECK_ID]
tru phonechecks:traces CHECK_ID
tru projects:create [NAME]
tru projects:list [PROJECT_ID]
tru projects:update [PROJECT-ID]
tru simchecks:create [PHONE_NUMBER]
tru simchecks:list [CHECK_ID]
tru simchecks:traces CHECK_ID
tru subscriberchecks:create [PHONE_NUMBER]
tru subscriberchecks:list [CHECK_ID]
tru subscriberchecks:traces CHECK_ID
tru usage:daily
tru usage:hourly
tru usage:monthly
tru workspaces:list
tru workspaces:selected
tru workspaces:switch DATA_RESIDENCY WORKSPACE_ID

`tru analytics:pck:daily`

Get Daily PhoneCheck Analytics. By default returns most recent analytics.

USAGE
  $ tru analytics:pck:daily [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g project_id or network_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for analytics. e.g --search='date>=2021-03-29'
  --sort=<value>         sort query in the form "{parameter_name},{direction}". For example, "date,asc" or "date,desc".

DESCRIPTION
  Get Daily PhoneCheck Analytics. By default returns most recent analytics.

See code: dist/commands/analytics/pck/daily.ts

`tru analytics:pck:hourly`

Get Hourly PhoneCheck Analytics. By default returns most recent analytics.

USAGE
  $ tru analytics:pck:hourly [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g project_id or network_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for analytics. e.g --search='date>=2021-03-29'
  --sort=<value>         sort query in the form "{parameter_name},{direction}". For example, "date,asc" or "date,desc".

DESCRIPTION
  Get Hourly PhoneCheck Analytics. By default returns most recent analytics.

See code: dist/commands/analytics/pck/hourly.ts

`tru analytics:pck:monthly`

Get Monthly PhoneCheck Analytics. By default returns most recent analytics.

USAGE
  $ tru analytics:pck:monthly [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g project_id or network_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for analytics. e.g --search='date>=2021-03-29'
  --sort=<value>         sort query in the form "{parameter_name},{direction}". For example, "date,asc" or "date,desc".

DESCRIPTION
  Get Monthly PhoneCheck Analytics. By default returns most recent analytics.

See code: dist/commands/analytics/pck/monthly.ts

`tru analytics:sck:daily`

Get Daily SimCheck Analytics. By default returns most recent analytics.

USAGE
  $ tru analytics:sck:daily [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g project_id or network_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for analytics. e.g --search='date>=2021-03-29'
  --sort=<value>         sort query in the form "{parameter_name},{direction}". For example, "date,asc" or "date,desc".

DESCRIPTION
  Get Daily SimCheck Analytics. By default returns most recent analytics.

See code: dist/commands/analytics/sck/daily.ts

`tru analytics:sck:hourly`

Get Hourly SimCheck Analytics. By default returns most recent analytics.

USAGE
  $ tru analytics:sck:hourly [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g project_id or network_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for analytics. e.g --search='date>=2021-03-29'
  --sort=<value>         sort query in the form "{parameter_name},{direction}". For example, "date,asc" or "date,desc".

DESCRIPTION
  Get Hourly SimCheck Analytics. By default returns most recent analytics.

See code: dist/commands/analytics/sck/hourly.ts

`tru analytics:sck:monthly`

Get Monthly SimCheck Analytics. By default returns most recent analytics.

USAGE
  $ tru analytics:sck:monthly [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g project_id or network_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for analytics. e.g --search='date>=2021-03-29'
  --sort=<value>         sort query in the form "{parameter_name},{direction}". For example, "date,asc" or "date,desc".

DESCRIPTION
  Get Monthly SimCheck Analytics. By default returns most recent analytics.

See code: dist/commands/analytics/sck/monthly.ts

`tru analytics:suk:daily`

Get Daily SubscriberCheck Analytics. By default returns most recent analytics.

USAGE
  $ tru analytics:suk:daily [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g project_id or network_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for analytics. e.g --search='date>=2021-03-29'
  --sort=<value>         sort query in the form "{parameter_name},{direction}". For example, "date,asc" or "date,desc".

DESCRIPTION
  Get Daily SubscriberCheck Analytics. By default returns most recent analytics.

See code: dist/commands/analytics/suk/daily.ts

`tru analytics:suk:hourly`

Get Hourly SubscriberCheck Analytics. By default returns most recent analytics.

USAGE
  $ tru analytics:suk:hourly [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g project_id or network_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for analytics. e.g --search='date>=2021-03-29'
  --sort=<value>         sort query in the form "{parameter_name},{direction}". For example, "date,asc" or "date,desc".

DESCRIPTION
  Get Hourly SubscriberCheck Analytics. By default returns most recent analytics.

See code: dist/commands/analytics/suk/hourly.ts

`tru analytics:suk:monthly`

Get Monthly SubscriberCheck Analytics. By default returns most recent analytics.

USAGE
  $ tru analytics:suk:monthly [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g project_id or network_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for analytics. e.g --search='date>=2021-03-29'
  --sort=<value>         sort query in the form "{parameter_name},{direction}". For example, "date,asc" or "date,desc".

DESCRIPTION
  Get Monthly SubscriberCheck Analytics. By default returns most recent analytics.

See code: dist/commands/analytics/suk/monthly.ts

`tru coverage:country CODE`

Retrieve country based coverage and prices

USAGE
  $ tru coverage:country [CODE] [--debug] [--help] [--project-dir <value>] [--columns <value> | -x] [--sort <value>]
    [--filter <value>] [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ]

ARGUMENTS
  CODE  two letter code ISO 3166-1 alpha-2 or country dialing code

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --project-dir=<value>  The directory that contains the tru.json Project configuration file
  --sort=<value>         property to sort by (prepend '-' for descending)

DESCRIPTION
  Retrieve country based coverage and prices

See code: dist/commands/coverage/country.ts

`tru coverage:reach DEVICE-IP`

Find if a certain device ip is reachable

USAGE
  $ tru coverage:reach [DEVICE-IP] [--debug] [--help] [--project-dir <value>] [--columns <value> | -x] [--sort
    <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ]

ARGUMENTS
  DEVICE-IP  the device ip in ipv4 or ipv6 format

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --project-dir=<value>  The directory that contains the tru.json Project configuration file
  --sort=<value>         property to sort by (prepend '-' for descending)

DESCRIPTION
  Find if a certain device ip is reachable

See code: dist/commands/coverage/reach.ts

`tru help [COMMAND]`

Display help for tru.

USAGE
  $ tru help [COMMAND] [-n]

ARGUMENTS
  COMMAND  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for tru.

See code: @oclif/plugin-help

`tru login IDP`

Login to tru.ID

USAGE
  $ tru login [IDP]

ARGUMENTS
  IDP  (google|github|microsoft) The Identity Provider

DESCRIPTION
  Login to tru.ID

See code: dist/commands/login/index.ts

`tru oauth2:token`

Creates an OAuth2 token

USAGE
  $ tru oauth2:token [--debug] [--help] [--project-dir <value>] [--output csv|json|yaml | --no-truncate | ] [-x |
    ] [--no-header | ]

FLAGS
  -x, --extended         show extra columns
  --debug                enables debug logging for the CLI
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --project-dir=<value>  The directory that contains the tru.json Project configuration file

DESCRIPTION
  Creates an OAuth2 token

EXAMPLES
  # use project credentials to create token

    $ tru oauth2:token --project-dir path/to/project

  # assign a token to a variable in shell
  $ TOKEN=$(tru oauth2:token --project-dir path/to/project --no-header)
  $ echo $TOKEN
  Emesua0F7gj3qOaav7UaKaBwefaaefaAxlrdGom_mb3U.78Od2d9XpvTQbd44eM1Uf7nzz9e9nezs5TRjPmpDnMc

See code: dist/commands/oauth2/token.ts

`tru phonechecks:create [PHONE_NUMBER]`

Creates a PhoneCheck within a project

USAGE
  $ tru phonechecks:create [PHONE_NUMBER] [--debug] [--help] [--project-dir <value>] [--output csv|json|yaml |  | ]

ARGUMENTS
  PHONE_NUMBER  the phone number to perform the Check on

FLAGS
  --debug                enables debug logging for the CLI
  --help                 show CLI help
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --project-dir=<value>  The directory that contains the tru.json Project configuration file

DESCRIPTION
  Creates a PhoneCheck within a project

See code: dist/commands/phonechecks/create.ts

`tru phonechecks:list [CHECK_ID]`

Lists details for all PhoneChecks or a specific PhoneCheck if the a check-id argument is passed

USAGE
  $ tru phonechecks:list [CHECK_ID] [--debug] [--help] [--project-dir <value>] [--columns <value> | -x] [--sort
    <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--page-number
    <value>] [--page-size <value>] [--search <value>]

ARGUMENTS
  CHECK_ID  the check_id for the Check to list

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource. Ignored if the "check_id" argument
                         is used.
  --page-size=<value>    [default: 10] the page size to return in list resource request. Ignored if the "check_id"
                         argument is used.
  --project-dir=<value>  The directory that contains the tru.json Project configuration file
  --search=<value>       a RSQL search query. To ensure correct parsing put your query in quotes. For example "--search
                         'status==COMPLETED'". Ignored if the "check_id" argument is used.
  --sort=<value>         [default: created_at,desc] sort query in the form "{parameter_name},{direction}". For example,
                         "created_at,asc" or "created_at,desc". Ignored if the "check_id" argument is used.

DESCRIPTION
  Lists details for all PhoneChecks or a specific PhoneCheck if the a check-id argument is passed

See code: dist/commands/phonechecks/list.ts

`tru phonechecks:traces CHECK_ID`

Get the traces of a PhoneCheck

USAGE
  $ tru phonechecks:traces [CHECK_ID] [--debug] [--help] [--project-dir <value>] [--columns <value> | -x] [--sort
    <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--trace-id
    <value>]

ARGUMENTS
  CHECK_ID  the check_id for which we want to get the traces

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --project-dir=<value>  The directory that contains the tru.json Project configuration file
  --sort=<value>         property to sort by (prepend '-' for descending)
  --trace-id=<value>     the trace-id for which we want to get the logs

DESCRIPTION
  Get the traces of a PhoneCheck

See code: dist/commands/phonechecks/traces.ts

`tru projects:create [NAME]`

Creates a new Project

USAGE
  $ tru projects:create [NAME] [--debug] [--help] [--project-dir <value>] [--phonecheck-callback <value> | ] [--mode
    live|sandbox] [--output csv|json|yaml |  | ]

ARGUMENTS
  NAME  the name of the project to create

FLAGS
  --debug                        enables debug logging for the CLI
  --help                         show CLI help
  --mode=<option>                Set the project mode to "live" or "sandbox"
                                 <options: live|sandbox>
  --output=<option>              output in a more machine friendly format
                                 <options: csv|json|yaml>
  --phonecheck-callback=<value>  set a callback to be invoked when a PhoneCheck reaches an end state
  --project-dir=<value>          The directory that contains the tru.json Project configuration file

DESCRIPTION
  Creates a new Project

EXAMPLES
  $ tru projects:create
  What is the name of the project?: My first project
  Creating Project "My first project"

  $ tru projects:create --phonecheck-callback https://example.com/callback

  $ tru projects:create --mode sandbox

  $ tru projects:create --mode live

See code: dist/commands/projects/create.ts

`tru projects:list [PROJECT_ID]`

Lists details for all Projects or a Projects that match a given criteria

USAGE
  $ tru projects:list [PROJECT_ID] [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>]
    [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--page-number <value>] [--page-size <value>]
    [--search <value>]

ARGUMENTS
  PROJECT_ID  the project_id for the Project to retrieve

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource. Ignored if the "project_id"
                         argument is used.
  --page-size=<value>    [default: 10] the page size to return in list resource request. Ignored if the "project_id"
                         argument is used.
  --search=<value>       a RSQL search query. To ensure correct parsing put your query in quotes. For example "--search
                         'name=p*'". Ignored if the "project_id" argument is used.
  --sort=<value>         [default: created_at,desc] sort query in the form "{parameter_name},{direction}". For example,
                         "created_at,asc" or "created_at,desc". Ignored if the "project_id" argument is used.

DESCRIPTION
  Lists details for all Projects or a Projects that match a given criteria

See code: dist/commands/projects/list.ts

`tru projects:update [PROJECT-ID]`

Update an existing Project

USAGE
  $ tru projects:update [PROJECT-ID] [--debug] [--help] [--project-dir <value>] [--phonecheck-callback <value> |
    --remove-phonecheck-callback] [--mode live|sandbox] [--output csv|json|yaml |  | ]

ARGUMENTS
  PROJECT-ID  the ID of the project to update

FLAGS
  --debug                        enables debug logging for the CLI
  --help                         show CLI help
  --mode=<option>                Set the project mode to "live" or "sandbox"
                                 <options: live|sandbox>
  --output=<option>              output in a more machine friendly format
                                 <options: csv|json|yaml>
  --phonecheck-callback=<value>  set a callback to be invoked when a PhoneCheck reaches an end state
  --project-dir=<value>          The directory that contains the tru.json Project configuration file
  --remove-phonecheck-callback   remove the PhoneCheck callback configuration from the Project

DESCRIPTION
  Update an existing Project

EXAMPLES
  $ tru projects:update --phonecheck-callback https://example.com/callback

  $ tru projects:update --remove-phonecheck-callback

  $ tru projects:update --mode sandbox

  $ tru projects:update --mode live

See code: dist/commands/projects/update.ts

`tru simchecks:create [PHONE_NUMBER]`

Create SIMChecks within a Project

USAGE
  $ tru simchecks:create [PHONE_NUMBER] [--debug] [--help] [--project-dir <value>] [--output csv|json|yaml |  | ]

ARGUMENTS
  PHONE_NUMBER  the phone number to perform the Check on

FLAGS
  --debug                enables debug logging for the CLI
  --help                 show CLI help
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --project-dir=<value>  The directory that contains the tru.json Project configuration file

DESCRIPTION
  Create SIMChecks within a Project

See code: dist/commands/simchecks/create.ts

`tru simchecks:list [CHECK_ID]`

Lists details for all SIMChecks or a specific SIMCheck if the a check-id argument is passed

USAGE
  $ tru simchecks:list [CHECK_ID] [--debug] [--help] [--project-dir <value>] [--columns <value> | -x] [--sort
    <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--page-number
    <value>] [--page-size <value>] [--search <value>]

ARGUMENTS
  CHECK_ID  the check_id for the Check to list

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource. Ignored if the "check_id" argument
                         is used.
  --page-size=<value>    [default: 10] the page size to return in list resource request. Ignored if the "check_id"
                         argument is used.
  --project-dir=<value>  The directory that contains the tru.json Project configuration file
  --search=<value>       a RSQL search query. To ensure correct parsing put your query in quotes. For example "--search
                         'status==COMPLETED'". Ignored if the "check_id" argument is used.
  --sort=<value>         [default: created_at,desc] sort query in the form "{parameter_name},{direction}". For example,
                         "created_at,asc" or "created_at,desc". Ignored if the "check_id" argument is used.

DESCRIPTION
  Lists details for all SIMChecks or a specific SIMCheck if the a check-id argument is passed

See code: dist/commands/simchecks/list.ts

`tru simchecks:traces CHECK_ID`

Get the traces of a SIMCheck

USAGE
  $ tru simchecks:traces [CHECK_ID] [--debug] [--help] [--project-dir <value>] [--columns <value> | -x] [--sort
    <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--trace-id
    <value>]

ARGUMENTS
  CHECK_ID  the check_id for which we want to get the traces

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --project-dir=<value>  The directory that contains the tru.json Project configuration file
  --sort=<value>         property to sort by (prepend '-' for descending)
  --trace-id=<value>     the trace-id for which we want to get the logs

DESCRIPTION
  Get the traces of a SIMCheck

See code: dist/commands/simchecks/traces.ts

`tru subscriberchecks:create [PHONE_NUMBER]`

Creates SubscriberChecks within a project

USAGE
  $ tru subscriberchecks:create [PHONE_NUMBER] [--debug] [--help] [--project-dir <value>] [--output csv|json|yaml |  | ]

ARGUMENTS
  PHONE_NUMBER  the phone number to perform the Check on

FLAGS
  --debug                enables debug logging for the CLI
  --help                 show CLI help
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --project-dir=<value>  The directory that contains the tru.json Project configuration file

DESCRIPTION
  Creates SubscriberChecks within a project

See code: dist/commands/subscriberchecks/create.ts

`tru subscriberchecks:list [CHECK_ID]`

Lists details for all SubscriberChecks or a specific SubscriberCheck if the a check-id argument is passed

USAGE
  $ tru subscriberchecks:list [CHECK_ID] [--debug] [--help] [--project-dir <value>] [--columns <value> | -x] [--sort
    <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--page-number
    <value>] [--page-size <value>] [--search <value>]

ARGUMENTS
  CHECK_ID  the check_id for the Check to list

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource. Ignored if the "check_id" argument
                         is used.
  --page-size=<value>    [default: 10] the page size to return in list resource request. Ignored if the "check_id"
                         argument is used.
  --project-dir=<value>  The directory that contains the tru.json Project configuration file
  --search=<value>       a RSQL search query. To ensure correct parsing put your query in quotes. For example "--search
                         'status==COMPLETED'". Ignored if the "check_id" argument is used.
  --sort=<value>         [default: created_at,desc] sort query in the form "{parameter_name},{direction}". For example,
                         "created_at,asc" or "created_at,desc". Ignored if the "check_id" argument is used.

DESCRIPTION
  Lists details for all SubscriberChecks or a specific SubscriberCheck if the a check-id argument is passed

See code: dist/commands/subscriberchecks/list.ts

`tru subscriberchecks:traces CHECK_ID`

Get the traces of a SubscriberCheck

USAGE
  $ tru subscriberchecks:traces [CHECK_ID] [--debug] [--help] [--project-dir <value>] [--columns <value> | -x] [--sort
    <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--trace-id
    <value>]

ARGUMENTS
  CHECK_ID  the check_id for which we want to get the traces

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --project-dir=<value>  The directory that contains the tru.json Project configuration file
  --sort=<value>         property to sort by (prepend '-' for descending)
  --trace-id=<value>     the trace-id for which we want to get the logs

DESCRIPTION
  Get the traces of a SubscriberCheck

See code: dist/commands/subscriberchecks/traces.ts

`tru usage:daily`

Get Daily Usage. The date range defaults to the last 7 days.

USAGE
  $ tru usage:daily [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g product_id or project_id or product_id,project_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for usage. date is required e.g --search='date>=2021-03-29'
  --sort=<value>         property to sort by (prepend '-' for descending)

DESCRIPTION
  Get Daily Usage. The date range defaults to the last 7 days.

See code: dist/commands/usage/daily.ts

`tru usage:hourly`

Get Hourly Usage. The date range defaults to the last 12 hours.

USAGE
  $ tru usage:hourly [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g product_id or project_id or product_id,project_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for usage. date is required e.g --search='date>=2021-03-29'
  --sort=<value>         property to sort by (prepend '-' for descending)

DESCRIPTION
  Get Hourly Usage. The date range defaults to the last 12 hours.

See code: dist/commands/usage/hourly.ts

`tru usage:monthly`

Get Monthly Usage. The date range defaults to the last 6 months.

USAGE
  $ tru usage:monthly [--debug] [--help] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output
    csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ] [--search <value>] [--group-by <value>] [--page-number
    <value>] [--page-size <value>]

FLAGS
  -x, --extended         show extra columns
  --columns=<value>      only show provided columns (comma-separated)
  --csv                  output is csv format [alias: --output=csv]
  --debug                enables debug logging for the CLI
  --filter=<value>       filter property by partial string matching, ex: name=foo
  --group-by=<value>     group results by one or more fields e.g product_id or project_id or product_id,project_id
  --help                 show CLI help
  --no-header            hide table header from output
  --no-truncate          do not truncate output to fit screen
  --output=<option>      output in a more machine friendly format
                         <options: csv|json|yaml>
  --page-number=<value>  [default: 1] the page number to return in the list resource.
  --page-size=<value>    [default: 10] the page size to return in list resource request.
  --search=<value>       the RSQL query for usage. date is required e.g --search='date>=2021-03-29'
  --sort=<value>         property to sort by (prepend '-' for descending)

DESCRIPTION
  Get Monthly Usage. The date range defaults to the last 6 months.

See code: dist/commands/usage/monthly.ts

`tru workspaces:list`

List of available workspaces

USAGE
  $ tru workspaces:list [--debug] [--help] [--output csv|json|yaml | --no-truncate | ] [--no-header | ]

FLAGS
  --debug            enables debug logging for the CLI
  --help             show CLI help
  --no-header        hide table header from output
  --no-truncate      do not truncate output to fit screen
  --output=<option>  output in a more machine friendly format
                     <options: csv|json|yaml>

DESCRIPTION
  List of available workspaces

See code: dist/commands/workspaces/list.ts

`tru workspaces:selected`

Displays selected workspace information

USAGE
  $ tru workspaces:selected [--debug] [--help] [--output csv|json|yaml | --no-truncate | ] [--no-header | ]

FLAGS
  --debug            enables debug logging for the CLI
  --help             show CLI help
  --no-header        hide table header from output
  --no-truncate      do not truncate output to fit screen
  --output=<option>  output in a more machine friendly format
                     <options: csv|json|yaml>

DESCRIPTION
  Displays selected workspace information

See code: dist/commands/workspaces/selected.ts

`tru workspaces:switch DATA_RESIDENCY WORKSPACE_ID`

Switch workspaces

USAGE
  $ tru workspaces:switch [DATA_RESIDENCY] [WORKSPACE_ID] [--debug] [--help] [--output csv|json|yaml | --no-truncate |
    ] [--no-header | ]

ARGUMENTS
  DATA_RESIDENCY  data residency where the workspace is located
  WORKSPACE_ID    selected Workspace

FLAGS
  --debug            enables debug logging for the CLI
  --help             show CLI help
  --no-header        hide table header from output
  --no-truncate      do not truncate output to fit screen
  --output=<option>  output in a more machine friendly format
                     <options: csv|json|yaml>

DESCRIPTION
  Switch workspaces

See code: dist/commands/workspaces/switch.ts

Development

Commits

The release process will generate/update a CHANGELOG based on commit messages. In order to do this commits should follow Conventional Commits v1.0.0.

If you forget to follow this the release process allows for manual editing of the CHANGELOG.

Releases

Releases should be performed on the dev branch and the related commits then merged into the main branch.

CHANGELOG & Package Version

The CLI uses standard-version to generate a changelog and bump the package version.

To update the README with new CLI instructions and add new version info to the CHANGELOG run:

$ npm run release

Additional parameters supported by standard-version can be passed as follows:

$ npm run release {additional_parameters}

For example:

$ npm run release --dry-run

Commit and Tag

If all goes well, we're ready to mark the release as complete.

Once the CHANGELOG and version in package.json are correct ensure the file updates are staged and run the following replacing current_version with the version of the CLI being released:

$ git commit -m 'chore(release): v{current_version}'
  git tag v{currentVersion}
  git push origin v{currentVersion}
  git push origin canary

Build & Release

Merge canary into main to release and the installers are automatically test and publish to NPM @latest. All commits on canary will also publish to NPM with a @canary tag.

Release MacOS Installer

To release the installers create a .env file with the following, including valid AWS credentials and an NPM token:

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
NPM_TOKEN=

Publish to NPM

To publish to NPM tagged with canary run:

$ npm run npm:publish:dev

For a full production release run:

$ npm run npm:publish:prod

Configuration

Every run of the CLI will check to see if all required configuration is in place. This is achieved through a hook.

For more inforation see the Oclif Configuration How to.

Files

README.md

Latest commit

History

README.md

File metadata and controls

Usage

Commands

tru analytics:pck:daily

tru analytics:pck:hourly

tru analytics:pck:monthly

tru analytics:sck:daily

tru analytics:sck:hourly

tru analytics:sck:monthly

tru analytics:suk:daily

tru analytics:suk:hourly

tru analytics:suk:monthly

tru coverage:country CODE

tru coverage:reach DEVICE-IP

tru help [COMMAND]

tru login IDP

tru oauth2:token

tru phonechecks:create [PHONE_NUMBER]

tru phonechecks:list [CHECK_ID]

tru phonechecks:traces CHECK_ID

tru projects:create [NAME]

tru projects:list [PROJECT_ID]

tru projects:update [PROJECT-ID]

tru simchecks:create [PHONE_NUMBER]

tru simchecks:list [CHECK_ID]

tru simchecks:traces CHECK_ID

tru subscriberchecks:create [PHONE_NUMBER]

tru subscriberchecks:list [CHECK_ID]

tru subscriberchecks:traces CHECK_ID

tru usage:daily

tru usage:hourly

tru usage:monthly

tru workspaces:list

tru workspaces:selected

tru workspaces:switch DATA_RESIDENCY WORKSPACE_ID