@coveo/cli
TypeScript icon, indicating that this package has built-in type declarations

3.2.4 • Public • Published

@coveo/cli

oclif Version Codecov Downloads/week License

Usage

$ npm install -g @coveo/cli
$ coveo COMMAND
running command...
$ coveo (--version)
@coveo/cli/3.2.4 linux-x64 node-v20.9.0
$ coveo --help [COMMAND]
USAGE
  $ coveo COMMAND
...

Configuration

The Coveo CLI is based on oclif and uses the following paths:

  • cacheDir - CLI cache directory
    • macOS: ~/Library/Caches/@coveo/cli
    • Unix: ~/.cache/@coveo/cli
    • Windows: %LOCALAPPDATA%\@coveo\cli
    • Can be overridden with XDG_CACHE_HOME
  • configDir - CLI config directory
    • Unix: ~/.config/@coveo/cli
    • Windows: %LOCALAPPDATA%\@coveo\cli
    • Can be overridden with XDG_CONFIG_HOME
  • dataDir - CLI data directory
    • Unix: ~/.data/@coveo/cli
    • Windows: %LOCALAPPDATA%\@coveo\cli
    • Can be overridden with XDG_DATA_HOME

The Coveo CLI may not function if you do not have read and write access to those directories.

The main config file of the Coveo CLI is stored in a JSON file in configDir.

Commands

coveo atomic:cmp NAME

Scaffold a new custom component. Meant to be executed in a component library created using the coveo atomic:init --lib command, or in an npm project, or in an empty folder.

USAGE
  $ coveo atomic:cmp [NAME] [--type page|result]

ARGUMENTS
  NAME  The name of your component.

FLAGS
  --type=<option>  The kind of component to initialize.
                   <options: page|result>

DESCRIPTION
  Scaffold a new custom component. Meant to be executed in a component library created using the `coveo atomic:init
  --lib` command, or in an npm project, or in an empty folder.

ALIASES
  $ coveo atomic:cmp

EXAMPLES
  $ coveo atomic:cmp --type=page myAwesomeComponent

  $ coveo atomic:cmp --type=result mySuperResultComponent

coveo atomic:component NAME

Scaffold a new custom component. Meant to be executed in a component library created using the coveo atomic:init --lib command, or in an npm project, or in an empty folder.

USAGE
  $ coveo atomic:component [NAME] [--type page|result]

ARGUMENTS
  NAME  The name of your component.

FLAGS
  --type=<option>  The kind of component to initialize.
                   <options: page|result>

DESCRIPTION
  Scaffold a new custom component. Meant to be executed in a component library created using the `coveo atomic:init
  --lib` command, or in an npm project, or in an empty folder.

ALIASES
  $ coveo atomic:cmp

EXAMPLES
  $ coveo atomic:component --type=page myAwesomeComponent

  $ coveo atomic:component --type=result mySuperResultComponent

See code: src/commands/atomic/component.ts

coveo atomic:deploy

Deploy your search application to the Coveo infrastructure.

USAGE
  $ coveo atomic:deploy [-p <value>] [-c <value>] [-o <value>]

FLAGS
  -c, --config=coveo.deploy.json                     [default: coveo.deploy.json] The path to the deployment JSON
                                                     configuration.
  -o, --organization=targetorganizationg7dg3gd       The unique identifier of the organization where to deploy the
                                                     hosted page. If not specified, the organization you are connected
                                                     to will be used.
  -p, --pageId=7944ff4a-9943-4999-a3f6-3e81a7f6fb0a  The existing ID of the target Hosted search page.

DESCRIPTION
  Deploy your search application to the Coveo infrastructure.

  The target "config" must contain the following parameters:
  {
  "name": "The name of the hosted search page.",
  "dir": "The directory of the hosted search page.",
  "htmlEntryFile": {
  "path": "The path to an HTML file containing the HTML markup of the hosted page."
  },
  "javascriptEntryFiles": [
  {
  "path": "The path to a bundled Javascript file.",
  "isModule": "Whether the inline code should be treated as a JavaScript module. If this property is true, the type
  property will be set to "module" on the script tag."
  }
  ],
  "javascriptUrls": [
  {
  "path": "The URL of the JavaScript source file.",
  "isModule": "Whether the inline code should be treated as a JavaScript module. If this property is true, the type
  property will be set to "module" on the script tag."
  }
  ],
  "cssEntryFiles": [
  {
  "path": "The path to a bundled CSS file."
  }
  ],
  "cssUrls": [
  {
  "path": "The URL of the CSS stylesheet."
  }
  ]
  }

ALIASES
  $ coveo atomic:deploy

EXAMPLES
  Create a new Hosted Page according to the configuration in the file "coveo.deploy.json"

    $ coveo atomic:deploy

  Update the Hosted Page whose ID is "7944ff4a-9943-4999-a3f6-3e81a7f6fb0a" according to the configuration in the file
  "coveo.deploy.json"

    $ coveo atomic:deploy -p 7944ff4a-9943-4999-a3f6-3e81a7f6fb0a

  Create a new Hosted Page according to the configuration in the file located at "./configs/myconfig.json"

    $ coveo atomic:deploy -c ./configs/myconfig.json

coveo atomic:init NAME

Scaffold a project to work with the Coveo Atomic Framework.

USAGE
  $ coveo atomic:init [NAME] [--type app|application|lib|library]

ARGUMENTS
  NAME  The name of your project.

FLAGS
  --type=<option>  The kind of project to initialize. Use `app`/`application` to start a new Atomic search page project,
                   and `lib`/`library` to start a custom component library.
                   <options: app|application|lib|library>

DESCRIPTION
  Scaffold a project to work with the Coveo Atomic Framework.

EXAMPLES
  $ coveo atomic:init --type=app myAwesomeSearchPage

  $ coveo atomic:init --type=lib myCustomAtomicComponentsLibrary

See code: src/commands/atomic/init.ts

coveo auth:login

Log in to the Coveo Platform using the OAuth2 flow.

USAGE
  $ coveo auth:login [-r US|us|EU|eu|AU|au|CA|ca] [-e dev|stg|hipaa|prod] [-o <value>]

FLAGS
  -e, --environment=<option>  [default: prod] The Coveo Platform environment to log in to.
                              <options: dev|stg|hipaa|prod>
  -o, --organization=myOrgID  The identifier of the organization to log in to. If not specified, the CLI logs you in to
                              the first available organization. See also commands `config:get`, `config:set`, and
                              `org:list`.
  -r, --region=<option>       [default: us] The Coveo Platform region to log in to. See
                              <https://docs.coveo.com/en/2976>.
                              <options: US|us|EU|eu|AU|au|CA|ca>

DESCRIPTION
  Log in to the Coveo Platform using the OAuth2 flow.
  Note: TCP port 32111 or 52296 must be available.

EXAMPLES
  $ coveo auth:login

See code: src/commands/auth/login.ts

coveo auth:token

Log in to the Coveo Platform using an access token.

USAGE
  $ coveo auth:token [-r US|us|EU|eu|AU|au|CA|ca] [-e dev|stg|hipaa|prod] [-s]

FLAGS
  -e, --environment=<option>  [default: prod] The Coveo Platform environment to log in to.
                              <options: dev|stg|hipaa|prod>
  -r, --region=<option>       [default: us] The Coveo Platform region to log in to. See
                              <https://docs.coveo.com/en/2976>.
                              <options: US|us|EU|eu|AU|au|CA|ca>
  -s, --[no-]stdin            Whether to read the token from stdin. Default to true when running in a CI environment.

DESCRIPTION
  Log in to the Coveo Platform using an access token.

EXAMPLES
  $ coveo auth:token

See code: src/commands/auth/token.ts

coveo config:get [KEY]

Display the current Coveo CLI configuration.

USAGE
  $ coveo config:get [KEY]

ARGUMENTS
  KEY  The config key for which to show the value

DESCRIPTION
  Display the current Coveo CLI configuration.

EXAMPLES
  Get all the configuration values

    $ coveo config:get

  Get the organization to which you are connected

    $ coveo config:get organization

  Get the access token given to you by the Coveo Platform

    $ coveo config:get accessToken

See code: src/commands/config/get.ts

coveo config:set

Modify the current Coveo CLI configuration.

USAGE
  $ coveo config:set [-o <value>]

FLAGS
  -o, --organization=myOrgID  The identifier of the organization inside which to perform operations. See
                              <https://docs.coveo.com/en/1562/#organization-id-and-other-information>.

DESCRIPTION
  Modify the current Coveo CLI configuration.

EXAMPLES
  connect to a different organization

    $ coveo config:set --organization myOrgId

See code: src/commands/config/set.ts

coveo help [COMMAND]

Display help for coveo.

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

See code: @oclif/plugin-help

coveo org:create NAME

Create a new test Coveo organization.

USAGE
  $ coveo org:create [NAME] [-s]

ARGUMENTS
  NAME  The name to assign to the new organization.

FLAGS
  -s, --[no-]setDefaultOrganization  Set the created organization as the default one

DESCRIPTION
  Create a new test Coveo organization.

See code: src/commands/org/create.ts

coveo org:list

List Coveo organizations.

USAGE
  $ coveo org:list [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml |  |
    [--csv | --no-truncate]] [--no-header | ]

FLAGS
  -x, --extended     show extra columns
  --columns=<value>  only show provided columns (comma-separated)
  --csv              output is csv format [alias: --output=csv]
  --filter=<value>   filter property by partial string matching, ex: name=foo
  --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>
  --sort=<value>     property to sort by (prepend '-' for descending)

DESCRIPTION
  List Coveo organizations.

See code: src/commands/org/list.ts

coveo org:resources:list

List available Snapshots in an organization

USAGE
  $ coveo org:resources:list [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml |  |
    [--csv | --no-truncate]] [--no-header | ] [-o <value>]

FLAGS
  -o, --organization=targetorganizationg7dg3gd  The unique identifier of the organization containing the snapshots. If
                                                not specified, the organization you are connected to will be used.
  -x, --extended                                show extra columns
  --columns=<value>                             only show provided columns (comma-separated)
  --csv                                         output is csv format [alias: --output=csv]
  --filter=<value>                              filter property by partial string matching, ex: name=foo
  --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>
  --sort=<value>                                property to sort by (prepend '-' for descending)

DESCRIPTION
  List available Snapshots in an organization

EXAMPLES
  $ coveo org:resources:list -o=myOrgId

See code: src/commands/org/resources/list.ts

coveo org:resources:model:create

Create a Snapshot Pull Model

USAGE
  $ coveo org:resources:model:create

DESCRIPTION
  Create a Snapshot Pull Model

See code: src/commands/org/resources/model/create.ts

coveo org:resources:monitor SNAPSHOTID

Monitor a Snapshot operation

USAGE
  $ coveo org:resources:monitor [SNAPSHOTID] [-w <value>] [-o <value>]

ARGUMENTS
  SNAPSHOTID  The unique identifier of the target snapshot.

FLAGS
  -o, --organization=targetorganizationg7dg3gd  The unique identifier of the organization containing the snapshot. If
                                                not specified, the organization you are connected to will be used.
  -w, --wait=seconds                            [default: 60] The maximum number of seconds to wait before the commands
                                                exits with a timeout error. A value of zero means that the command will
                                                wait indefinitely.

DESCRIPTION
  Monitor a Snapshot operation

EXAMPLES
  Monitor the status of the "mysnapshotid" snapshot in the "myorgid" organization.

    $ coveo org:resources:monitor --organization myorgid --snapshotId mysnapshotid

See code: src/commands/org/resources/monitor.ts

coveo org:resources:preview

Preview the changes that running coveo org:resources:push would cause

USAGE
  $ coveo org:resources:preview [-w <value>] [-p none|light|detailed] [-o <value>] [-s <value> | ] [-d]

FLAGS
  -d, --showMissingResources                    Preview resources deletion when enabled
  -o, --organization=targetorganizationg7dg3gd  The unique identifier of the organization where to preview the changes
                                                If not specified, the organization you are connected to will be used.
  -p, --previewLevel=(none|light|detailed)      [default: detailed] The verbosity of the preview. The `light` preview is
                                                faster to generate but only contains a limited amount of information, as
                                                opposed to the `detailed` preview that takes more time to generate, but
                                                returns a diff representation of all the changes to apply.
  -s, --snapshotId=<value>                      The unique identifier of the snapshot to pull. If not specified, a new
                                                snapshot will be created. You can list available snapshot in your
                                                organization with org:resources:list
  -w, --wait=seconds                            [default: 60] The maximum number of seconds to wait before the commands
                                                exits with a timeout error. A value of zero means that the command will
                                                wait indefinitely.

DESCRIPTION
  Preview the changes that running `coveo org:resources:push` would cause

EXAMPLES
  $ coveo org:resources:preview

  $ coveo org:resources:preview -o=myOrgId

  $ coveo org:resources:preview -o=myOrgId -d

See code: src/commands/org/resources/preview.ts

coveo org:resources:pull

Pull resources from an organization

USAGE
  $ coveo org:resources:pull [-w <value>] [-o <value>] [-g] [-f] [-m <value> | [-s <value> | -r
    EXTENSION|FEATURED_RESULT|FIELD|FILTER|MAPPING|QUERY_PARAMETER|QUERY_PIPELINE|QUERY_PIPELINE_CONDITION|RANKING_EXPRE
    SSION|RANKING_WEIGHT|SEARCH_PAGE|SECURITY_PROVIDER|SOURCE|STOP_WORD|SUBSCRIPTION|THESAURUS|TRIGGER] |  | ]

FLAGS
  -f, --overwrite                               Overwrite resources directory if it exists.
  -g, --[no-]git                                Whether to create a git repository when creating a new project.
  -m, --model=path/to/snapshot.json             The path to a snapshot pull model. This flag is useful when you want to
                                                include only specific resource items in your snapshot (e.g., a subset of
                                                sources). Use the "org:resources:model:create" command to create a new
                                                Snapshot Pull Model
  -o, --organization=targetorganizationg7dg3gd  The unique identifier of the organization from which to pull the
                                                resources If not specified, the organization you are connected to will
                                                be used.
  -r, --resourceTypes=type1 type2...            [default:
                                                EXTENSION,FEATURED_RESULT,FIELD,FILTER,MAPPING,QUERY_PARAMETER,QUERY_PIP
                                                ELINE,QUERY_PIPELINE_CONDITION,RANKING_EXPRESSION,RANKING_WEIGHT,SEARCH_
                                                PAGE,SECURITY_PROVIDER,SOURCE,STOP_WORD,SUBSCRIPTION,THESAURUS,TRIGGER]
                                                The resources types to pull from the organization.
  -s, --snapshotId=<value>                      The unique identifier of the snapshot to pull. If not specified, a new
                                                snapshot will be created. You can list available snapshot in your
                                                organization with org:resources:list
  -w, --wait=seconds                            [default: 60] The maximum number of seconds to wait before the commands
                                                exits with a timeout error. A value of zero means that the command will
                                                wait indefinitely.

DESCRIPTION
  Pull resources from an organization

EXAMPLES
  Pull all resources from the organization in which you are authenticated

    $ coveo org:resources:pull

  Pull all resources from the organization whose ID is "myorgid" and do not timeout

    $ coveo org:resources:pull --organization myorgid --wait 0

  Pull only the resources specified in the snapshot pull model

    $ coveo org:resources:pull --model my/snapshot/pull/model.json

  Pull all query pipelines and fields available in the organization

    $ coveo org:resources:pull --resourceTypes QUERY_PIPELINE FIELD,

See code: src/commands/org/resources/pull.ts

coveo org:resources:push

Preview, validate and deploy your changes to the destination org

USAGE
  $ coveo org:resources:push [-w <value>] [-p none|light|detailed] [-o <value>] [--deleteMissingResources]

FLAGS
  -o, --organization=targetorganizationg7dg3gd  The unique identifier of the organization where to send the changes If
                                                not specified, the organization you are connected to will be used.
  -p, --previewLevel=(none|light|detailed)      [default: detailed] The verbosity of the preview. The `light` preview is
                                                faster to generate but only contains a limited amount of information, as
                                                opposed to the `detailed` preview that takes more time to generate, but
                                                returns a diff representation of all the changes to apply.
  -w, --wait=seconds                            [default: 60] The maximum number of seconds to wait before the commands
                                                exits with a timeout error. A value of zero means that the command will
                                                wait indefinitely.
  --deleteMissingResources                      Delete missing resources when enabled

DESCRIPTION
  Preview, validate and deploy your changes to the destination org

EXAMPLES
  Preview, validate and deploy resources to the organization in which you are authenticated

    $ coveo org:resources:push

  Preview, validate and deploy resources to the organization whose ID is "myorgid"

    $ coveo org:resources:push --organization myorgid

  Validate and deploy resources without displaying a preview

    $ coveo org:resources:push --previewLevel none

  Preview, validate and deploy resources, but also delete from the organization all the resources that are not
  available inside the "resources/" directory

    $ coveo org:resources:push --deleteMissingResources

See code: src/commands/org/resources/push.ts

coveo org:search:dump

Dump the content of one or more sources in CSV format.

USAGE
  $ coveo org:search:dump -s <value> [-p <value>] [-x <value>] [-d <value>] [-n <value>] [-f <value>] [-c <value>]

FLAGS
  -c, --chunkSize=<value>           [default: 10000] The maximum number of results to dump into each CSV file.
  -d, --destination=<value>         [default: .] The folder in which to create the CSV files. The data dump will fail if
                                    the folder doesn't exist.
  -f, --additionalFilter=<value>    The additional search filter to apply while getting the content. See
                                    <https://docs.coveo.com/en/1552>.
  -n, --name=<value>                [default: indexdump] The base name to use when creating a new CSV file. If more than
                                    one file is created, the CLI will append `_2`, `_3`, etc. to each new file name
                                    after the first one.
  -p, --pipeline=<value>            The name of the query pipeline through which to get content. If not specified, the
                                    default query pipeline is used. See <https://docs.coveo.com/en/180>
  -s, --source=mySourceName...      (required) The names (not the identifiers) of the sources from which to get content.
  -x, --fieldsToExclude=<value>...  The fields to exclude from the data dump. If not specified, all fields are included.

DESCRIPTION
  Dump the content of one or more sources in CSV format.

  Note: DictionnaryFields/Values are experimentally supported. In case of failure, you should exclude them using the
  `-x` flag.

EXAMPLES
  Get content indexed into the "My Web Source" and "My Sitemap Source" sources.

    $ coveo org:search:dump --source "My Web Source" "My Sitemap Source"

  Get all the products coming from the "Search" pipeline that are either in the "Shorts" or "Jackets" category.

    $ coveo org:search:dump --source Products --pipeline Search --additionalFilter "@cat_categories==(Shorts, \
      Jackets)"

  Get all the products coming from the "Search" pipeline that are in the "Shorts" category and have the color "Black".

    $ coveo org:search:dump --source Products --pipeline Search --additionalFilter "@cat_categories==Shorts AND \
      @color==Black"

  Get all the documents without the fields "ec_description" and "ec_summary" in them.

    $ coveo org:search:dump --fieldsToExclude ec_description ec_summary

See code: src/commands/org/search/dump.ts

coveo plugins

List installed plugins.

USAGE
  $ coveo plugins [--core]

FLAGS
  --core  Show core plugins.

DESCRIPTION
  List installed plugins.

EXAMPLES
  $ coveo plugins

See code: @oclif/plugin-plugins

coveo plugins:install PLUGIN...

Installs a plugin into the CLI.

USAGE
  $ coveo plugins:install PLUGIN...

ARGUMENTS
  PLUGIN  Plugin to install.

FLAGS
  -f, --force    Run yarn install with force flag.
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Installs a plugin into the CLI.
  Can be installed from npm or a git url.

  Installation of a user-installed plugin will override a core plugin.

  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
  the CLI without the need to patch and update the whole CLI.


ALIASES
  $ coveo plugins:add

EXAMPLES
  $ coveo plugins:install myplugin 

  $ coveo plugins:install https://github.com/someuser/someplugin

  $ coveo plugins:install someuser/someplugin

coveo plugins:inspect PLUGIN...

Displays installation properties of a plugin.

USAGE
  $ coveo plugins:inspect PLUGIN...

ARGUMENTS
  PLUGIN  [default: .] Plugin to inspect.

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Displays installation properties of a plugin.

EXAMPLES
  $ coveo plugins:inspect myplugin

See code: @oclif/plugin-plugins

coveo plugins:install PLUGIN...

Installs a plugin into the CLI.

USAGE
  $ coveo plugins:install PLUGIN...

ARGUMENTS
  PLUGIN  Plugin to install.

FLAGS
  -f, --force    Run yarn install with force flag.
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Installs a plugin into the CLI.
  Can be installed from npm or a git url.

  Installation of a user-installed plugin will override a core plugin.

  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
  the CLI without the need to patch and update the whole CLI.


ALIASES
  $ coveo plugins:add

EXAMPLES
  $ coveo plugins:install myplugin 

  $ coveo plugins:install https://github.com/someuser/someplugin

  $ coveo plugins:install someuser/someplugin

See code: @oclif/plugin-plugins

coveo plugins:link PLUGIN

Links a plugin into the CLI for development.

USAGE
  $ coveo plugins:link PLUGIN

ARGUMENTS
  PATH  [default: .] path to plugin

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Links a plugin into the CLI for development.
  Installation of a linked plugin will override a user-installed or core plugin.

  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
  command will override the user-installed or core plugin implementation. This is useful for development work.


EXAMPLES
  $ coveo plugins:link myplugin

See code: @oclif/plugin-plugins

coveo plugins:uninstall PLUGIN...

Removes a plugin from the CLI.

USAGE
  $ coveo plugins:uninstall PLUGIN...

ARGUMENTS
  PLUGIN  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ coveo plugins:unlink
  $ coveo plugins:remove

coveo plugins:uninstall PLUGIN...

Removes a plugin from the CLI.

USAGE
  $ coveo plugins:uninstall PLUGIN...

ARGUMENTS
  PLUGIN  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ coveo plugins:unlink
  $ coveo plugins:remove

See code: @oclif/plugin-plugins

coveo plugins:uninstall PLUGIN...

Removes a plugin from the CLI.

USAGE
  $ coveo plugins:uninstall PLUGIN...

ARGUMENTS
  PLUGIN  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ coveo plugins:unlink
  $ coveo plugins:remove

coveo plugins:update

Update installed plugins.

USAGE
  $ coveo plugins:update [-h] [-v]

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Update installed plugins.

See code: @oclif/plugin-plugins

coveo source:catalog:add SOURCEID

Index a JSON document into a Coveo Catalog source. See https://docs.coveo.com/en/2956 for more information.

USAGE
  $ coveo source:catalog:add [SOURCEID] [-f <value>] [-c <value> | ] [-m] [-n] [--fullUpload] [--skipFullUploadCheck]

ARGUMENTS
  SOURCEID  The identifier of the Catalog source on which to perform the add operation. See `source:list` to obtain the
            identifier.

FLAGS
  -c, --maxConcurrent=<value>
      [default: 10] The maximum number of requests to send concurrently. Increasing this value increases the speed at
      which documents are indexed to the Coveo platform. However, if you run into memory or throttling issues, consider
      reducing this value.

  -f, --files=myfile.json...
      Combinaison of JSON files and folders (containing JSON files) to push. Can be repeated.

  -m, --[no-]createMissingFields
      Analyse documents to detect and automatically create missing fields in the destination organization. When enabled,
      an error will be thrown if a field is used to store data of inconsistent type across documents.

  -n, --[no-]normalizeInvalidFields
      Whether to normalize invalid fields detected from the documents. If set to `false`, an error will be thrown when
      invalid fields are detected.

  --fullUpload
      Controls the way your items are added to your catalog source.

      Setting this option to false will trigger a document update (Default operation). Useful to perform incremental
      updates for smaller adjustments to your catalog that do not require pushing the entire catalog. A document update
      must only be performed after a full catalog upload.
      See https://docs.coveo.com/en/l62e0540

      Setting this option to true will trigger a full catalog upload. This process acts as a full rebuild of your catalog
      source. Therefore, previous items that are not included in the new payload will be deleted.
      See https://docs.coveo.com/en/lb4a0344

  --skipFullUploadCheck
      Do not check whether a full catalog upload was triggered on the target source.

DESCRIPTION
  Index a JSON document into a Coveo Catalog source. See https://docs.coveo.com/en/2956 for more information.

See code: @coveo/cli-plugin-source

coveo source:catalog:new NAME

Create a new catalog source in a Coveo organization

USAGE
  $ coveo source:catalog:new [NAME] [-v PRIVATE|SECURED|SHARED]

ARGUMENTS
  NAME  The name of the source to create.

FLAGS
  -v, --sourceVisibility=(PRIVATE|SECURED|SHARED)  [default: SECURED] Controls the content security option that should
                                                   be applied to the items in a source. See
                                                   https://docs.coveo.com/en/1779/index-content/content-security

DESCRIPTION
  Create a new catalog source in a Coveo organization

See code: @coveo/cli-plugin-source

coveo source:list

List all available push sources in your Coveo organization

USAGE
  $ coveo source:list [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml |  |
    [--csv | --no-truncate]] [--no-header | ]

FLAGS
  -x, --extended     show extra columns
  --columns=<value>  only show provided columns (comma-separated)
  --csv              output is csv format [alias: --output=csv]
  --filter=<value>   filter property by partial string matching, ex: name=foo
  --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>
  --sort=<value>     property to sort by (prepend '-' for descending)

DESCRIPTION
  List all available push sources in your Coveo organization

See code: @coveo/cli-plugin-source

coveo source:push:add SOURCEID

Index a JSON document into a Coveo Push source. See https://github.com/coveo/cli/wiki/Pushing-JSON-Files-with-the-Coveo-CLI for more information.

USAGE
  $ coveo source:push:add [SOURCEID] [-f <value>] [-c <value> | ] [-m] [-n]

ARGUMENTS
  SOURCEID  The identifier of the source on which to perform the add operation. See source:list to obtain the
            identifier.

FLAGS
  -c, --maxConcurrent=<value>        [default: 10] The maximum number of requests to send concurrently. Increasing this
                                     value increases the speed at which documents are indexed to the Coveo platform.
                                     However, if you run into memory or throttling issues, consider reducing this value.
  -f, --files=myfile.json...         Combinaison of JSON files and folders (containing JSON files) to push. Can be
                                     repeated.
  -m, --[no-]createMissingFields     Analyse documents to detect and automatically create missing fields in the
                                     destination organization. When enabled, an error will be thrown if a field is used
                                     to store data of inconsistent type across documents.
  -n, --[no-]normalizeInvalidFields  Whether to normalize invalid fields detected from the documents. If set to `false`,
                                     an error will be thrown when invalid fields are detected.

DESCRIPTION
  Index a JSON document into a Coveo Push source. See
  https://github.com/coveo/cli/wiki/Pushing-JSON-Files-with-the-Coveo-CLI for more information.

See code: @coveo/cli-plugin-source

coveo source:push:delete SOURCEID

Delete one or multiple items in a given Push source. See https://docs.coveo.com/en/171 and https://docs.coveo.com/en/131

USAGE
  $ coveo source:push:delete [SOURCEID] [-d <value> | -x <value>] [-c]

ARGUMENTS
  SOURCEID  The identifier of the Push source on which to perform the delete operation. To retrieve the list of
            available Push source identifiers, use the `source:push:list` command.

FLAGS
  -c, --[no-]deleteChildren
      Whether to delete all items that share the same base URI as the specified item to delete.

  -d, --deleteOlderThan=2000-01-01T00:00:00-06:00 OR 1506700606240
      If this flag is set, all items that have been added or updated in the source before the specified ISO 8601 date or
      Unix timestamp in milliseconds will be deleted. The documents will be deleted using the default queueDelay, meaning
      they will stay in the index for about 15 minutes after being marked for deletion.

  -x, --delete=<value>...
      The URIs of the items to delete. Can be repeated. If you want to delete more than one specific items, use the
      `--deleteOlderThan` flag instead.

DESCRIPTION
  Delete one or multiple items in a given Push source. See <https://docs.coveo.com/en/171> and
  <https://docs.coveo.com/en/131>

See code: @coveo/cli-plugin-source

coveo source:push:new NAME

Create a new push source in a Coveo organization

USAGE
  $ coveo source:push:new [NAME] [-v PRIVATE|SECURED|SHARED]

ARGUMENTS
  NAME  The name of the source to create.

FLAGS
  -v, --sourceVisibility=(PRIVATE|SECURED|SHARED)  [default: SECURED] Controls the content security option that should
                                                   be applied to the items in a source. See
                                                   https://docs.coveo.com/en/1779/index-content/content-security

DESCRIPTION
  Create a new push source in a Coveo organization

See code: @coveo/cli-plugin-source

coveo ui:create:angular NAME

Create a Coveo Headless-powered search page with the Angular web framework. See https://docs.coveo.com/headless and https://angular.io/.

USAGE
  $ coveo ui:create:angular [NAME] [-v <value>] [-d]

ARGUMENTS
  NAME  The name of the application to create.

FLAGS
  -d, --defaults         Whether to automatically select the default value for all prompts that have a default value.
  -v, --version=<value>  [default: 1.36.8] The version of @coveo/angular to use.

DESCRIPTION
  Create a Coveo Headless-powered search page with the Angular web framework. See <https://docs.coveo.com/headless> and
  <https://angular.io/>.

See code: src/commands/ui/create/angular.ts

coveo ui:create:atomic NAME

Create a Coveo Headless-powered search page with Coveo's own Atomic framework. See https://docs.coveo.com/atomic and https://docs.coveo.com/headless.

USAGE
  $ coveo ui:create:atomic [NAME] [-v <value>] [-p <value>]

ARGUMENTS
  NAME  The name of the application to create.

FLAGS
  -p, --pageId=7944ff4a-9943-4999-a3f6-3e81a7f6fb0a  The hosted search page ID.
  -v, --version=<value>                              [default: 1.40.0] The version of @coveo/create-atomic to use.

DESCRIPTION
  Create a Coveo Headless-powered search page with Coveo's own Atomic framework. See <https://docs.coveo.com/atomic> and
  <https://docs.coveo.com/headless>.

EXAMPLES
  $ coveo ui:create:atomic myapp

See code: src/commands/ui/create/atomic.ts

coveo ui:create:react NAME

Create a Coveo Headless-powered search page with the React web framework. See https://docs.coveo.com/headless and https://reactjs.org/.

USAGE
  $ coveo ui:create:react [NAME] [-v <value>]

ARGUMENTS
  NAME  The name of the application to create.

FLAGS
  -v, --version=<value>  [default: 1.38.17] Version of @coveo/cra-template to use.

DESCRIPTION
  Create a Coveo Headless-powered search page with the React web framework. See <https://docs.coveo.com/headless> and
  <https://reactjs.org/>.

EXAMPLES
  $ coveo ui:create:react myapp

  $ coveo ui:create:react --help

See code: src/commands/ui/create/react.ts

coveo ui:create:vue NAME

Create a Coveo Headless-powered search page with the Vue3 and Vite. See https://docs.coveo.com/headless and https://vuejs.org/.

USAGE
  $ coveo ui:create:vue [NAME] [-v <value>]

ARGUMENTS
  NAME  The name of the application to create.

FLAGS
  -v, --version=<value>  [default: 1.4.0] The version of @coveo/create-headless-vue to use.

DESCRIPTION
  Create a Coveo Headless-powered search page with the Vue3 and Vite. See <https://docs.coveo.com/headless> and
  <https://vuejs.org/>.

EXAMPLES
  $ coveo ui:create:vue myVueProject

  $ coveo ui:create:vue-v=1.2.3 myVueProject

See code: src/commands/ui/create/vue.ts

coveo ui:deploy

Deploy your search application to the Coveo infrastructure.

USAGE
  $ coveo ui:deploy [-p <value>] [-c <value>] [-o <value>]

FLAGS
  -c, --config=coveo.deploy.json                     [default: coveo.deploy.json] The path to the deployment JSON
                                                     configuration.
  -o, --organization=targetorganizationg7dg3gd       The unique identifier of the organization where to deploy the
                                                     hosted page. If not specified, the organization you are connected
                                                     to will be used.
  -p, --pageId=7944ff4a-9943-4999-a3f6-3e81a7f6fb0a  The existing ID of the target Hosted search page.

DESCRIPTION
  Deploy your search application to the Coveo infrastructure.

  The target "config" must contain the following parameters:
  {
  "name": "The name of the hosted search page.",
  "dir": "The directory of the hosted search page.",
  "htmlEntryFile": {
  "path": "The path to an HTML file containing the HTML markup of the hosted page."
  },
  "javascriptEntryFiles": [
  {
  "path": "The path to a bundled Javascript file.",
  "isModule": "Whether the inline code should be treated as a JavaScript module. If this property is true, the type
  property will be set to "module" on the script tag."
  }
  ],
  "javascriptUrls": [
  {
  "path": "The URL of the JavaScript source file.",
  "isModule": "Whether the inline code should be treated as a JavaScript module. If this property is true, the type
  property will be set to "module" on the script tag."
  }
  ],
  "cssEntryFiles": [
  {
  "path": "The path to a bundled CSS file."
  }
  ],
  "cssUrls": [
  {
  "path": "The URL of the CSS stylesheet."
  }
  ]
  }

ALIASES
  $ coveo atomic:deploy

EXAMPLES
  Create a new Hosted Page according to the configuration in the file "coveo.deploy.json"

    $ coveo ui:deploy

  Update the Hosted Page whose ID is "7944ff4a-9943-4999-a3f6-3e81a7f6fb0a" according to the configuration in the file
  "coveo.deploy.json"

    $ coveo ui:deploy -p 7944ff4a-9943-4999-a3f6-3e81a7f6fb0a

  Create a new Hosted Page according to the configuration in the file located at "./configs/myconfig.json"

    $ coveo ui:deploy -c ./configs/myconfig.json

See code: src/commands/ui/deploy.ts

coveo update [CHANNEL]

update the coveo CLI

USAGE
  $ coveo update [CHANNEL] [-a] [-v <value> | -i] [--force]

FLAGS
  -a, --available        Install a specific version.
  -i, --interactive      Interactively select version to install. This is ignored if a channel is provided.
  -v, --version=<value>  Install a specific version.
  --force                Force a re-download of the requested version.

DESCRIPTION
  update the coveo CLI

EXAMPLES
  Update to the stable channel:

    $ coveo update stable

  Update to a specific version:

    $ coveo update --version 1.0.0

  Interactively select version:

    $ coveo update --interactive

  See available versions:

    $ coveo update --available

See code: @oclif/plugin-update

coveo version

USAGE
  $ coveo version [--json] [--verbose]

FLAGS
  --verbose  Show additional information about the CLI.

GLOBAL FLAGS
  --json  Format output as json.

FLAG DESCRIPTIONS
  --verbose  Show additional information about the CLI.

    Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.

See code: @oclif/plugin-version

Dependencies (31)

Dev Dependencies (37)

Package Sidebar

Install

npm i @coveo/cli

Weekly Downloads

244

Version

3.2.4

License

Apache-2.0

Unpacked Size

477 kB

Total Files

261

Last publish

Collaborators

  • ndescoteaux-coveo
  • sallain
  • aboissinot
  • mmitiche
  • jkatofsky
  • agong-coveo
  • pixhel
  • ndlr
  • npmcoveo
  • camarois
  • lcoolen
  • coveo-organization
  • coveoit
  • olamothe
  • sssayegh
  • ylakhdar