@contextual-io/cli

v0.10.0

Published

6 days ago

Contextual CLI

0High
0Medium
0Low

nassero

oclif

@contextual-io/cli

Contextual CLI

Usage

$ npm install -g @contextual-io/cli
$ ctxl COMMAND
running command...
$ ctxl (--version)
@contextual-io/cli/0.10.0 linux-x64 node-v25.9.0
$ ctxl --help [COMMAND]
USAGE
  $ ctxl COMMAND
...

Commands

`ctxl autocomplete [SHELL]`

Display autocomplete installation instructions.

USAGE
  $ ctxl autocomplete [SHELL] [-r]

ARGUMENTS
  [SHELL]  (zsh|bash|powershell) Shell type

FLAGS
  -r, --refresh-cache  Refresh cache (ignores displaying instructions)

DESCRIPTION
  Display autocomplete installation instructions.

EXAMPLES
  $ ctxl autocomplete

  $ ctxl autocomplete bash

  $ ctxl autocomplete zsh

  $ ctxl autocomplete powershell

  $ ctxl autocomplete --refresh-cache

See code: @oclif/plugin-autocomplete

`ctxl config add CONFIG-ID`

Add a new config.

USAGE
  $ ctxl config add CONFIG-ID [-t <value>]

ARGUMENTS
  CONFIG-ID  id of config

FLAGS
  -t, --tenant-id=<value>  tenant id (if different from config id)

DESCRIPTION
  Add a new config.

EXAMPLES
  $ ctxl config add some-config-id --tenant-id my-tenant

`ctxl config current`

Get the current config.

USAGE
  $ ctxl config current [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get the current config.

EXAMPLES
  $ ctxl config current

`ctxl config delete CONFIG-ID`

Delete a config.

USAGE
  $ ctxl config delete CONFIG-ID

ARGUMENTS
  CONFIG-ID  id of config

DESCRIPTION
  Delete a config.

EXAMPLES
  $ ctxl config delete some-config-id

`ctxl config get [CONFIG-ID]`

Get a specific config.

USAGE
  $ ctxl config get [CONFIG-ID] [--json]

ARGUMENTS
  [CONFIG-ID]  id of config

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a specific config.

EXAMPLES
  $ ctxl config get

  $ ctxl config get some-config-id

`ctxl config list`

List all available configs.

USAGE
  $ ctxl config list [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List all available configs.

EXAMPLES
  $ ctxl config list

`ctxl config login`

USAGE
  $ ctxl config login

DESCRIPTION
  Login using the current config.

EXAMPLES
  $ ctxl config login

`ctxl config use CONFIG-ID`

Use a config.

USAGE
  $ ctxl config use CONFIG-ID

ARGUMENTS
  CONFIG-ID  id of config

DESCRIPTION
  Use a config.

EXAMPLES
  $ ctxl config use some-config-id

`ctxl help [COMMAND]`

Display help for ctxl.

USAGE
  $ ctxl 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 ctxl.

See code: @oclif/plugin-help

`ctxl mcp serve [INTERFACE]`

Start a local MCP HTTP server that connects to SolutionAI for a given interface type. By default it binds to http://localhost:5051/. The server fetches the full tool manifest from SolutionAI and serves all tools immediately. Pass a flowId with each tool call to target a specific flow, or use list_sessions to discover available flows.

USAGE
  $ ctxl mcp serve [INTERFACE] [-C <value>] [-f <value>] [-p <value>] [-t] [-V]

ARGUMENTS
  [INTERFACE]  [default: flow-editor] Interface type to scope tools for. Available interfaces depend on your platform
               version.

FLAGS
  -V, --verbose           emit verbose MCP runtime diagnostics
  -f, --flow=<value>      pre-filter session listing to a specific flow ID
  -p, --port=<value>      local HTTP port (default: 5051)
  -t, --[no-]tool-prefix  prefix all MCP tool names with ctxl_

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Start a local MCP HTTP server that connects to SolutionAI for a given interface type. By default it binds to
  http://localhost:5051/. The server fetches the full tool manifest from SolutionAI and serves all tools immediately.
  Pass a flowId with each tool call to target a specific flow, or use list_sessions to discover available flows.

EXAMPLES
  $ ctxl mcp serve

  $ ctxl mcp serve flow-editor --flow my-flow-id

`ctxl ra list [URI]`

List record audit trail.

USAGE
  $ ctxl ra list [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -I, --id=<value>               id
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List record audit trail.

ALIASES
  $ ctxl recordaudittrail search
  $ ctxl ra list
  $ ctxl ra search

EXAMPLES
  $ ctxl ra list

  $ ctxl ra list native-object:my-type

  $ ctxl ra list native-object:my-type/instance-1

  $ ctxl ra list --type my-type

  $ ctxl ra list --type my-type --id instance-1

  $ ctxl ra list --type my-type --order-by field1:desc

  $ ctxl ra list --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl ra search [URI]`

List record audit trail.

USAGE
  $ ctxl ra search [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -I, --id=<value>               id
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List record audit trail.

ALIASES
  $ ctxl recordaudittrail search
  $ ctxl ra list
  $ ctxl ra search

EXAMPLES
  $ ctxl ra search

  $ ctxl ra search native-object:my-type

  $ ctxl ra search native-object:my-type/instance-1

  $ ctxl ra search --type my-type

  $ ctxl ra search --type my-type --id instance-1

  $ ctxl ra search --type my-type --order-by field1:desc

  $ ctxl ra search --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl recordaudittrail list [URI]`

List record audit trail.

USAGE
  $ ctxl recordaudittrail list [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -I, --id=<value>               id
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List record audit trail.

ALIASES
  $ ctxl recordaudittrail search
  $ ctxl ra list
  $ ctxl ra search

EXAMPLES
  $ ctxl recordaudittrail list

  $ ctxl recordaudittrail list native-object:my-type

  $ ctxl recordaudittrail list native-object:my-type/instance-1

  $ ctxl recordaudittrail list --type my-type

  $ ctxl recordaudittrail list --type my-type --id instance-1

  $ ctxl recordaudittrail list --type my-type --order-by field1:desc

  $ ctxl recordaudittrail list --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl recordaudittrail search [URI]`

List record audit trail.

USAGE
  $ ctxl recordaudittrail search [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -I, --id=<value>               id
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List record audit trail.

ALIASES
  $ ctxl recordaudittrail search
  $ ctxl ra list
  $ ctxl ra search

EXAMPLES
  $ ctxl recordaudittrail search

  $ ctxl recordaudittrail search native-object:my-type

  $ ctxl recordaudittrail search native-object:my-type/instance-1

  $ ctxl recordaudittrail search --type my-type

  $ ctxl recordaudittrail search --type my-type --id instance-1

  $ ctxl recordaudittrail search --type my-type --order-by field1:desc

  $ ctxl recordaudittrail search --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl records add [URI]`

Create record(s).

USAGE
  $ ctxl records add [URI] [-C <value>] [-i <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -T, --type=<value>        type
  -i, --input-file=<value>  [default: -] file to read. can read stdin if value is '-'

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Create record(s).

ALIASES
  $ ctxl records create
  $ ctxl records import

EXAMPLES
  $ ctxl records add native-object:my-type

  $ ctxl records add --type my-type --input-file records.json

`ctxl records create [URI]`

Create record(s).

USAGE
  $ ctxl records create [URI] [-C <value>] [-i <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -T, --type=<value>        type
  -i, --input-file=<value>  [default: -] file to read. can read stdin if value is '-'

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Create record(s).

ALIASES
  $ ctxl records create
  $ ctxl records import

EXAMPLES
  $ ctxl records create native-object:my-type

  $ ctxl records create --type my-type --input-file records.json

`ctxl records delete [URI]`

Delete record(s).

USAGE
  $ ctxl records delete [URI] [-C <value>] [-I <value>...] [-T <value>]

ARGUMENTS
  [URI]  uri of record

FLAGS
  -I, --id=<value>...  id(s)
  -T, --type=<value>   type

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Delete record(s).

ALIASES
  $ ctxl records rm
  $ ctxl records remove

EXAMPLES
  $ ctxl records delete native-object:my-type/instance-1

  $ ctxl records delete native-object:my-type --id instance-1

  $ ctxl records delete native-object:my-type --id instance-1 --id instance-2

  $ ctxl records delete --type my-type --id instance-1

  $ ctxl records delete --type my-type --id instance-1 --id instance-2

`ctxl records get [URI]`

Get a record.

USAGE
  $ ctxl records get [URI] [-C <value>] [-I <value>...] [-T <value>] [--version <value>]

ARGUMENTS
  [URI]  uri of record

FLAGS
  -I, --id=<value>...    id(s)
  -T, --type=<value>     type
      --version=<value>  version

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Get a record.

EXAMPLES
  $ ctxl records get native-object:my-type/instance-1

  $ ctxl records get native-object:my-type/instance-1#2

  $ ctxl records get native-object:my-type --id instance-1

  $ ctxl records get native-object:my-type --id instance-1 --version 2

  $ ctxl records get native-object:my-type --id instance-1 --id instance-2

  $ ctxl records get --type my-type --id instance-1

  $ ctxl records get --type my-type --id instance-1 --id instance-2

`ctxl records import [URI]`

Create record(s).

USAGE
  $ ctxl records import [URI] [-C <value>] [-i <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -T, --type=<value>        type
  -i, --input-file=<value>  [default: -] file to read. can read stdin if value is '-'

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Create record(s).

ALIASES
  $ ctxl records create
  $ ctxl records import

EXAMPLES
  $ ctxl records import native-object:my-type

  $ ctxl records import --type my-type --input-file records.json

`ctxl records list [URI]`

List records.

USAGE
  $ ctxl records list [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List records.

ALIASES
  $ ctxl records search

EXAMPLES
  $ ctxl records list native-object:my-type

  $ ctxl records list --type my-type

  $ ctxl records list --type my-type --order-by field1:desc

  $ ctxl records list --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl records patch [URI]`

Patch a record.

USAGE
  $ ctxl records patch [URI] [-C <value>] [-a <value>...] [-I <value>] [-i <value>...] [-d <value>...] [-r
    <value>...] [-s <value>...] [-T <value>]

ARGUMENTS
  [URI]  uri of record

FLAGS
  -I, --id=<value>            id
  -T, --type=<value>          type
  -a, --add=<value>...        add field
  -d, --remove=<value>...     remove field
  -i, --increment=<value>...  increment field
  -r, --replace=<value>...    replace field
  -s, --set=<value>...        set field

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Patch a record.

EXAMPLES
  $ ctxl records patch native-object:my-type/instance-1 --set field1=value1

  $ ctxl records patch native-object:my-type --id instance-1 --remove field2

  $ ctxl records patch --type my-type --id instance-1 --increment field3=2

`ctxl records query [URI]`

Query records.

USAGE
  $ ctxl records query [URI] [-C <value>] [-e] [--include-total] [-o <value>...] [--page-size <value>]
    [--page-token <value>] [-p] [-q <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -T, --type=<value>         type
  -e, --export               export data as JSONL
  -o, --order-by=<value>...  order fields
  -p, --progress             show progress during export
  -q, --query-file=<value>   [default: -] file to read. can read stdin if value is '-'
      --include-total        include total count
      --page-size=<value>    number of records per page
      --page-token=<value>   page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Query records.

EXAMPLES
  $ ctxl records query native-object:my-type

  $ ctxl records query --type my-type --query-file query.json

  $ ctxl records query --type my-type --order-by field1:desc --query-file query.json

  $ ctxl records query --type my-type --include-total --query-file query.json

`ctxl records remove [URI]`

Delete record(s).

USAGE
  $ ctxl records remove [URI] [-C <value>] [-I <value>...] [-T <value>]

ARGUMENTS
  [URI]  uri of record

FLAGS
  -I, --id=<value>...  id(s)
  -T, --type=<value>   type

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Delete record(s).

ALIASES
  $ ctxl records rm
  $ ctxl records remove

EXAMPLES
  $ ctxl records remove native-object:my-type/instance-1

  $ ctxl records remove native-object:my-type --id instance-1

  $ ctxl records remove native-object:my-type --id instance-1 --id instance-2

  $ ctxl records remove --type my-type --id instance-1

  $ ctxl records remove --type my-type --id instance-1 --id instance-2

`ctxl records replace [URI]`

Replace a record.

USAGE
  $ ctxl records replace [URI] [-C <value>] [-I <value>] [-i <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of record

FLAGS
  -I, --id=<value>          id
  -T, --type=<value>        type
  -i, --input-file=<value>  [default: -] file to read. can read stdin if value is '-'

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Replace a record.

EXAMPLES
  $ ctxl records replace native-object:my-type/instance-1 --input-file record.json

  $ ctxl records replace native-object:my-type --id instance-1 --input-file record.json

  $ ctxl records replace --type my-type --id instance-1 --input-file record.json

`ctxl records rm [URI]`

Delete record(s).

USAGE
  $ ctxl records rm [URI] [-C <value>] [-I <value>...] [-T <value>]

ARGUMENTS
  [URI]  uri of record

FLAGS
  -I, --id=<value>...  id(s)
  -T, --type=<value>   type

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Delete record(s).

ALIASES
  $ ctxl records rm
  $ ctxl records remove

EXAMPLES
  $ ctxl records rm native-object:my-type/instance-1

  $ ctxl records rm native-object:my-type --id instance-1

  $ ctxl records rm native-object:my-type --id instance-1 --id instance-2

  $ ctxl records rm --type my-type --id instance-1

  $ ctxl records rm --type my-type --id instance-1 --id instance-2

`ctxl records search [URI]`

List records.

USAGE
  $ ctxl records search [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List records.

ALIASES
  $ ctxl records search

EXAMPLES
  $ ctxl records search native-object:my-type

  $ ctxl records search --type my-type

  $ ctxl records search --type my-type --order-by field1:desc

  $ ctxl records search --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl records stats [URI]`

Get the stats of a record.

USAGE
  $ ctxl records stats [URI] [-C <value>] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of record

FLAGS
  -I, --id=<value>    id
  -T, --type=<value>  type

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Get the stats of a record.

EXAMPLES
  $ ctxl records stats native-object:my-type/instance-1

  $ ctxl records stats native-object:my-type --id instance-1

  $ ctxl records stats --type my-type --id instance-1

`ctxl recordversions diff [URI] [VERSIONS]`

Diff two versions of a record.

USAGE
  $ ctxl recordversions diff [URI] [VERSIONS] [-C <value>] [--format console|json|jsonpatch] [-I <value>] [--no-moves]
    [--object-keys <value>] [-T <value>]

ARGUMENTS
  [URI]       uri of record
  [VERSIONS]  versions to compare

FLAGS
  -I, --id=<value>           id
  -T, --type=<value>         type
      --format=<option>      [default: console]
                             <options: console|json|jsonpatch>
      --no-moves             disable array moves detection
      --object-keys=<value>  [default: id,name] optional comma-separated properties to match 2 objects between array
                             versions

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Diff two versions of a record.

ALIASES
  $ ctxl rv diff

EXAMPLES
  $ ctxl recordversions diff native-object:my-type/instance-1

  $ ctxl recordversions diff native-object:my-type --id instance-1

  $ ctxl recordversions diff --type my-type --id instance-1

`ctxl recordversions list [URI]`

List record versions.

USAGE
  $ ctxl recordversions list [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -I, --id=<value>               id
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List record versions.

ALIASES
  $ ctxl recordversions search
  $ ctxl rv list
  $ ctxl rv search

EXAMPLES
  $ ctxl recordversions list

  $ ctxl recordversions list native-object:my-type

  $ ctxl recordversions list native-object:my-type/instance-1

  $ ctxl recordversions list --type my-type

  $ ctxl recordversions list --type my-type --id instance-1

  $ ctxl recordversions list --type my-type --order-by field1:desc

  $ ctxl recordversions list --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl recordversions rollback [URI]`

Rollback a record to a particular version.

USAGE
  $ ctxl recordversions rollback [URI] --version <value> [-C <value>] [--do-not-bump] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of record

FLAGS
  -I, --id=<value>       id
  -T, --type=<value>     type
      --do-not-bump      do not bump version number, removing every version past the given value
      --version=<value>  (required) version

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Rollback a record to a particular version.

ALIASES
  $ ctxl rv rollback

EXAMPLES
  $ ctxl recordversions rollback native-object:my-type/instance-1

  $ ctxl recordversions rollback native-object:my-type --id instance-1

  $ ctxl recordversions rollback --type my-type --id instance-1

`ctxl recordversions search [URI]`

List record versions.

USAGE
  $ ctxl recordversions search [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -I, --id=<value>               id
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List record versions.

ALIASES
  $ ctxl recordversions search
  $ ctxl rv list
  $ ctxl rv search

EXAMPLES
  $ ctxl recordversions search

  $ ctxl recordversions search native-object:my-type

  $ ctxl recordversions search native-object:my-type/instance-1

  $ ctxl recordversions search --type my-type

  $ ctxl recordversions search --type my-type --id instance-1

  $ ctxl recordversions search --type my-type --order-by field1:desc

  $ ctxl recordversions search --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl rv diff [URI] [VERSIONS]`

Diff two versions of a record.

USAGE
  $ ctxl rv diff [URI] [VERSIONS] [-C <value>] [--format console|json|jsonpatch] [-I <value>] [--no-moves]
    [--object-keys <value>] [-T <value>]

ARGUMENTS
  [URI]       uri of record
  [VERSIONS]  versions to compare

FLAGS
  -I, --id=<value>           id
  -T, --type=<value>         type
      --format=<option>      [default: console]
                             <options: console|json|jsonpatch>
      --no-moves             disable array moves detection
      --object-keys=<value>  [default: id,name] optional comma-separated properties to match 2 objects between array
                             versions

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Diff two versions of a record.

ALIASES
  $ ctxl rv diff

EXAMPLES
  $ ctxl rv diff native-object:my-type/instance-1

  $ ctxl rv diff native-object:my-type --id instance-1

  $ ctxl rv diff --type my-type --id instance-1

`ctxl rv list [URI]`

List record versions.

USAGE
  $ ctxl rv list [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -I, --id=<value>               id
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List record versions.

ALIASES
  $ ctxl recordversions search
  $ ctxl rv list
  $ ctxl rv search

EXAMPLES
  $ ctxl rv list

  $ ctxl rv list native-object:my-type

  $ ctxl rv list native-object:my-type/instance-1

  $ ctxl rv list --type my-type

  $ ctxl rv list --type my-type --id instance-1

  $ ctxl rv list --type my-type --order-by field1:desc

  $ ctxl rv list --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl rv rollback [URI]`

Rollback a record to a particular version.

USAGE
  $ ctxl rv rollback [URI] --version <value> [-C <value>] [--do-not-bump] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of record

FLAGS
  -I, --id=<value>       id
  -T, --type=<value>     type
      --do-not-bump      do not bump version number, removing every version past the given value
      --version=<value>  (required) version

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Rollback a record to a particular version.

ALIASES
  $ ctxl rv rollback

EXAMPLES
  $ ctxl rv rollback native-object:my-type/instance-1

  $ ctxl rv rollback native-object:my-type --id instance-1

  $ ctxl rv rollback --type my-type --id instance-1

`ctxl rv search [URI]`

List record versions.

USAGE
  $ ctxl rv search [URI] [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...] [-I <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -I, --id=<value>               id
  -S, --exact-search=<value>...  search fields exactly
  -T, --type=<value>             type
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List record versions.

ALIASES
  $ ctxl recordversions search
  $ ctxl rv list
  $ ctxl rv search

EXAMPLES
  $ ctxl rv search

  $ ctxl rv search native-object:my-type

  $ ctxl rv search native-object:my-type/instance-1

  $ ctxl rv search --type my-type

  $ ctxl rv search --type my-type --id instance-1

  $ ctxl rv search --type my-type --order-by field1:desc

  $ ctxl rv search --type my-type -s field1=value1 -s field2=value2 --include-total

`ctxl types add`

Create type(s).

USAGE
  $ ctxl types add [-C <value>] [-i <value>]

FLAGS
  -i, --input-file=<value>  [default: -] file to read. can read stdin if value is '-'

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Create type(s).

ALIASES
  $ ctxl types create
  $ ctxl types import

EXAMPLES
  $ ctxl types add

  $ ctxl types add --input-file types.json

`ctxl types create`

Create type(s).

USAGE
  $ ctxl types create [-C <value>] [-i <value>]

FLAGS
  -i, --input-file=<value>  [default: -] file to read. can read stdin if value is '-'

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Create type(s).

ALIASES
  $ ctxl types create
  $ ctxl types import

EXAMPLES
  $ ctxl types create

  $ ctxl types create --input-file types.json

`ctxl types delete [URI]`

Delete a type.

USAGE
  $ ctxl types delete [URI] [-C <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -T, --type=<value>  type

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Delete a type.

ALIASES
  $ ctxl types rm
  $ ctxl types remove

EXAMPLES
  $ ctxl types delete native-object:my-type

  $ ctxl types delete --type my-type

`ctxl types get [URI]`

Get a type.

USAGE
  $ ctxl types get [URI] [-C <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -T, --type=<value>  type

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Get a type.

EXAMPLES
  $ ctxl types get native-object:my-type

  $ ctxl types get --type my-type

`ctxl types import`

Create type(s).

USAGE
  $ ctxl types import [-C <value>] [-i <value>]

FLAGS
  -i, --input-file=<value>  [default: -] file to read. can read stdin if value is '-'

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Create type(s).

ALIASES
  $ ctxl types create
  $ ctxl types import

EXAMPLES
  $ ctxl types import

  $ ctxl types import --input-file types.json

`ctxl types list`

List types.

USAGE
  $ ctxl types list [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...]

FLAGS
  -S, --exact-search=<value>...  search fields exactly
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List types.

ALIASES
  $ ctxl types search

EXAMPLES
  $ ctxl types list

  $ ctxl types list --order-by field1:desc

  $ ctxl types list -s field1=value1 -s field2=value2 --include-total

`ctxl types remove [URI]`

Delete a type.

USAGE
  $ ctxl types remove [URI] [-C <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -T, --type=<value>  type

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Delete a type.

ALIASES
  $ ctxl types rm
  $ ctxl types remove

EXAMPLES
  $ ctxl types remove native-object:my-type

  $ ctxl types remove --type my-type

`ctxl types replace [URI]`

Replace a type.

USAGE
  $ ctxl types replace [URI] [-C <value>] [-i <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -T, --type=<value>        type
  -i, --input-file=<value>  [default: -] file to read. can read stdin if value is '-'

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Replace a type.

EXAMPLES
  $ ctxl types replace native-object:my-type --input-file record.json

  $ ctxl types replace --type my-type  --input-file record.json

`ctxl types rm [URI]`

Delete a type.

USAGE
  $ ctxl types rm [URI] [-C <value>] [-T <value>]

ARGUMENTS
  [URI]  uri of type

FLAGS
  -T, --type=<value>  type

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  Delete a type.

ALIASES
  $ ctxl types rm
  $ ctxl types remove

EXAMPLES
  $ ctxl types rm native-object:my-type

  $ ctxl types rm --type my-type

`ctxl types search`

List types.

USAGE
  $ ctxl types search [-C <value>] [-S <value>...] [-e] [-f <value>...] [--include-total] [-o <value>...]
    [--page-size <value>] [--page-token <value>] [-p] [-s <value>...] [-t <value>...]

FLAGS
  -S, --exact-search=<value>...  search fields exactly
  -e, --export                   export data as JSONL
  -f, --from=<value>...          search from
  -o, --order-by=<value>...      order fields
  -p, --progress                 show progress during export
  -s, --search=<value>...        search fields
  -t, --to=<value>...            search to
      --include-total            include total count
      --page-size=<value>        number of records per page
      --page-token=<value>       page token to fetch

GLOBAL FLAGS
  -C, --config-id=<value>  Specify config id to use for call.

DESCRIPTION
  List types.

ALIASES
  $ ctxl types search

EXAMPLES
  $ ctxl types search

  $ ctxl types search --order-by field1:desc

  $ ctxl types search -s field1=value1 -s field2=value2 --include-total

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

@contextual-io/cli

Usage

Commands

ctxl autocomplete [SHELL]

ctxl config add CONFIG-ID

ctxl config current

ctxl config delete CONFIG-ID

ctxl config get [CONFIG-ID]

ctxl config list

ctxl config login

ctxl config use CONFIG-ID

ctxl help [COMMAND]

ctxl mcp serve [INTERFACE]

ctxl ra list [URI]

ctxl ra search [URI]

ctxl recordaudittrail list [URI]

ctxl recordaudittrail search [URI]

ctxl records add [URI]

ctxl records create [URI]

ctxl records delete [URI]

ctxl records get [URI]

ctxl records import [URI]

ctxl records list [URI]

ctxl records patch [URI]

ctxl records query [URI]

ctxl records remove [URI]

ctxl records replace [URI]

ctxl records rm [URI]

ctxl records search [URI]

ctxl records stats [URI]

ctxl recordversions diff [URI] [VERSIONS]

ctxl recordversions list [URI]

ctxl recordversions rollback [URI]

ctxl recordversions search [URI]

ctxl rv diff [URI] [VERSIONS]

ctxl rv list [URI]

ctxl rv rollback [URI]

ctxl rv search [URI]

ctxl types add

ctxl types create

ctxl types delete [URI]

ctxl types get [URI]

ctxl types import

ctxl types list

ctxl types remove [URI]

ctxl types replace [URI]

ctxl types rm [URI]

ctxl types search

`ctxl autocomplete [SHELL]`

`ctxl config add CONFIG-ID`

`ctxl config current`

`ctxl config delete CONFIG-ID`

`ctxl config get [CONFIG-ID]`

`ctxl config list`

`ctxl config login`

`ctxl config use CONFIG-ID`

`ctxl help [COMMAND]`

`ctxl mcp serve [INTERFACE]`

`ctxl ra list [URI]`

`ctxl ra search [URI]`

`ctxl recordaudittrail list [URI]`

`ctxl recordaudittrail search [URI]`

`ctxl records add [URI]`

`ctxl records create [URI]`

`ctxl records delete [URI]`

`ctxl records get [URI]`

`ctxl records import [URI]`

`ctxl records list [URI]`

`ctxl records patch [URI]`

`ctxl records query [URI]`

`ctxl records remove [URI]`

`ctxl records replace [URI]`

`ctxl records rm [URI]`

`ctxl records search [URI]`

`ctxl records stats [URI]`

`ctxl recordversions diff [URI] [VERSIONS]`

`ctxl recordversions list [URI]`

`ctxl recordversions rollback [URI]`

`ctxl recordversions search [URI]`

`ctxl rv diff [URI] [VERSIONS]`

`ctxl rv list [URI]`

`ctxl rv rollback [URI]`

`ctxl rv search [URI]`

`ctxl types add`

`ctxl types create`

`ctxl types delete [URI]`

`ctxl types get [URI]`

`ctxl types import`

`ctxl types list`

`ctxl types remove [URI]`

`ctxl types replace [URI]`

`ctxl types rm [URI]`

`ctxl types search`