https://github.com/digitaloptimizationgroup/dogcli
Digital Optimization Group - ADN CLI - Developer Preview
https://github.com/digitaloptimizationgroup/dogcli
ab-testing application-delivery-network edge-deployment pwa single-page-applications
Last synced: 11 months ago
JSON representation
Digital Optimization Group - ADN CLI - Developer Preview
- Host: GitHub
- URL: https://github.com/digitaloptimizationgroup/dogcli
- Owner: DigitalOptimizationGroup
- Created: 2019-03-22T17:18:44.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-01-04T03:01:04.000Z (about 3 years ago)
- Last Synced: 2025-01-21T08:31:52.607Z (about 1 year ago)
- Topics: ab-testing, application-delivery-network, edge-deployment, pwa, single-page-applications
- Language: TypeScript
- Homepage: https://docs.digitaloptgroup.com/
- Size: 397 KB
- Stars: 0
- Watchers: 4
- Forks: 1
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# dogcli
Digital Optimization Group Edge Platform CLI - Developer Preview
* [dogcli](#dogcli)
* [Usage](#usage)
* [Commands](#commands)
# Usage
```sh-session
$ npm install -g @digitaloptgroup/cli
$ dog COMMAND
running command...
$ dog (-v|--version|version)
@digitaloptgroup/cli/0.0.1-dev-preview-36 linux-x64 node-v10.14.2
$ dog --help [COMMAND]
USAGE
$ dog COMMAND
...
```
# Commands
* [`dog apps:apply COLOR`](#dog-appsapply-color)
* [`dog apps:build`](#dog-appsbuild)
* [`dog apps:current`](#dog-appscurrent)
* [`dog apps:init`](#dog-appsinit)
* [`dog apps:list`](#dog-appslist)
* [`dog apps:new FRIENDLYNAME`](#dog-appsnew-friendlyname)
* [`dog apps:rollback COLOR`](#dog-appsrollback-color)
* [`dog apps:sharedataset EMAIL`](#dog-appssharedataset-email)
* [`dog autocomplete [SHELL]`](#dog-autocomplete-shell)
* [`dog cms:login`](#dog-cmslogin)
* [`dog cms:preview URL`](#dog-cmspreview-url)
* [`dog domains:add HOSTNAME`](#dog-domainsadd-hostname)
* [`dog domains:list`](#dog-domainslist)
* [`dog domains:status HOSTNAME`](#dog-domainsstatus-hostname)
* [`dog help [COMMAND]`](#dog-help-command)
* [`dog login`](#dog-login)
* [`dog logout`](#dog-logout)
* [`dog logs:assetLoadTime`](#dog-logsassetloadtime)
* [`dog logs:caughtError`](#dog-logscaughterror)
* [`dog logs:clientPing`](#dog-logsclientping)
* [`dog logs:error`](#dog-logserror)
* [`dog logs:fps`](#dog-logsfps)
* [`dog logs:longTasksTiming`](#dog-logslongtaskstiming)
* [`dog logs:mouseDistance`](#dog-logsmousedistance)
* [`dog logs:orientationChange`](#dog-logsorientationchange)
* [`dog logs:outcome`](#dog-logsoutcome)
* [`dog logs:pageScrolling`](#dog-logspagescrolling)
* [`dog logs:pageView`](#dog-logspageview)
* [`dog logs:performanceTiming`](#dog-logsperformancetiming)
* [`dog logs:proxyLogs`](#dog-logsproxylogs)
* [`dog logs:rapidClicking`](#dog-logsrapidclicking)
* [`dog logs:serverLogs`](#dog-logsserverlogs)
* [`dog logs:timeOnPage`](#dog-logstimeonpage)
* [`dog logs:timeOnSite`](#dog-logstimeonsite)
* [`dog logs:variationInViewport`](#dog-logsvariationinviewport)
* [`dog logs:variationMousedown`](#dog-logsvariationmousedown)
* [`dog plugins`](#dog-plugins)
* [`dog plugins:install PLUGIN...`](#dog-pluginsinstall-plugin)
* [`dog plugins:link PLUGIN`](#dog-pluginslink-plugin)
* [`dog plugins:uninstall PLUGIN...`](#dog-pluginsuninstall-plugin)
* [`dog plugins:update`](#dog-pluginsupdate)
* [`dog proxy:abtest`](#dog-proxyabtest)
* [`dog proxy:apply`](#dog-proxyapply)
* [`dog proxy:canary`](#dog-proxycanary)
* [`dog proxy:gatekeep ORIGIN`](#dog-proxygatekeep-origin)
* [`dog proxy:localhost [PORT]`](#dog-proxylocalhost-port)
* [`dog proxy:prod PRODUCTIONBACKEND`](#dog-proxyprod-productionbackend)
* [`dog proxy:refresh`](#dog-proxyrefresh)
* [`dog proxy:rollback`](#dog-proxyrollback)
* [`dog proxy:show`](#dog-proxyshow)
* [`dog share`](#dog-share)
* [`dog start`](#dog-start)
## `dog apps:apply COLOR`
deploy your application to a chosen color
```
USAGE
$ dog apps:apply COLOR
ARGUMENTS
COLOR (blue|green) the backend color to deploy to
OPTIONS
-p, --path=path
--force
EXAMPLES
dog deploy blue
dog deploy blue --force
dog deploy green --path ./custom/script.js
```
_See code: [src/commands/apps/apply.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/apps/apply.ts)_
## `dog apps:build`
build your application from a template script
```
USAGE
$ dog apps:build
OPTIONS
-p, --pathToConfig=pathToConfig [default: ./dog-app-config.json]
EXAMPLE
$ dog apps:build
# Use a non-default path to your config
dog apps:build --pathToConfig ./dog-app-config.json
# Or with flag character
dog apps:build -p ./dog-app-config.json
```
_See code: [src/commands/apps/build.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/apps/build.ts)_
## `dog apps:current`
show currently selected application
```
USAGE
$ dog apps:current
```
_See code: [src/commands/apps/current.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/apps/current.ts)_
## `dog apps:init`
initalize an app in this directory (should be the root of your project)
```
USAGE
$ dog apps:init
```
_See code: [src/commands/apps/init.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/apps/init.ts)_
## `dog apps:list`
list all apps in your account
```
USAGE
$ dog apps:list
```
_See code: [src/commands/apps/list.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/apps/list.ts)_
## `dog apps:new FRIENDLYNAME`
create a new application
```
USAGE
$ dog apps:new FRIENDLYNAME
ARGUMENTS
FRIENDLYNAME a friendly display name for your project. the id will be created from this.
```
_See code: [src/commands/apps/new.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/apps/new.ts)_
## `dog apps:rollback COLOR`
rollback a color to a prior deployment
```
USAGE
$ dog apps:rollback COLOR
OPTIONS
--force
EXAMPLE
$ dog apps:rollback blue
# Force rollback a backend receiving production traffic
$ dog apps:rollback blue --force
```
_See code: [src/commands/apps/rollback.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/apps/rollback.ts)_
## `dog apps:sharedataset EMAIL`
share your BigQuery dataset with an email address associated with a Google Cloud Account
```
USAGE
$ dog apps:sharedataset EMAIL
EXAMPLE
$ dog apps:sharedataset sarah.smith@example.com
```
_See code: [src/commands/apps/sharedataset.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/apps/sharedataset.ts)_
## `dog autocomplete [SHELL]`
display autocomplete installation instructions
```
USAGE
$ dog autocomplete [SHELL]
ARGUMENTS
SHELL shell type
OPTIONS
-r, --refresh-cache Refresh cache (ignores displaying instructions)
EXAMPLES
$ dog autocomplete
$ dog autocomplete bash
$ dog autocomplete zsh
$ dog autocomplete --refresh-cache
```
_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v0.1.1/src/commands/autocomplete/index.ts)_
## `dog cms:login`
login & open the cms UI
```
USAGE
$ dog cms:login
```
_See code: [src/commands/cms/login.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/cms/login.ts)_
## `dog cms:preview URL`
generate a preview link to a chosen domain
```
USAGE
$ dog cms:preview URL
ARGUMENTS
URL [default: http://localhost:3000] must be a fully qualified domain name
EXAMPLE
$ dog cms:preview http://localhost:3000
$ dog cms:preview https://www.example.com
```
_See code: [src/commands/cms/preview.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/cms/preview.ts)_
## `dog domains:add HOSTNAME`
attach a CNAME to your application
```
USAGE
$ dog domains:add HOSTNAME
OPTIONS
-v, --validation=http|email|cname [default: http] specify the validation method - http happens inline, email will
send to the WHOIS contacts, cname will return a record that needs to be placed
EXAMPLE
$ dog domains:add www.example.com
# Validate your domain automatically (default)
$ dog domains:add www.example.com --validation http
# Validate your domain by placing an extra CNAME with auth code
$ dog domains:add www.example.com --validation cname
# Validate your domain by receiving an email sent to your WHOIS contacts
$ dog domains:add www.example.com --validation email
```
_See code: [src/commands/domains/add.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/domains/add.ts)_
## `dog domains:list`
list all domains associated with this app
```
USAGE
$ dog domains:list
```
_See code: [src/commands/domains/list.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/domains/list.ts)_
## `dog domains:status HOSTNAME`
check the status of a custom hostname
```
USAGE
$ dog domains:status HOSTNAME
EXAMPLE
$ dog domains:status www.example.com
```
_See code: [src/commands/domains/status.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/domains/status.ts)_
## `dog help [COMMAND]`
display help for dog
```
USAGE
$ dog help [COMMAND]
ARGUMENTS
COMMAND command to show help for
OPTIONS
--all see all commands in CLI
```
_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v2.2.0/src/commands/help.ts)_
## `dog login`
sign in to your account
```
USAGE
$ dog login
```
_See code: [src/commands/login.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/login.ts)_
## `dog logout`
sign out of your account
```
USAGE
$ dog logout
```
_See code: [src/commands/logout.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logout.ts)_
## `dog logs:assetLoadTime`
live js & css asset performance
```
USAGE
$ dog logs:assetLoadTime
OPTIONS
-a, --asset=asset filter by fqdn of asset (https://example.com/build/main.js)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:assetLoadTime
{"asset":"https://example.com/build/main.js","color":"green","duration":85,"protocol":"h2","rid":"abc-567","vid":"abc-
123"}
# Filter by asset
$ dog logs:assetLoadTime --asset https://example.com/build/main.js
# Pretty print JSON
$ dog logs:assetLoadTime --prettyjson
{
"asset": "https://example.com/build/main.js",
"color": "green",
"duration": 85,
"protocol": "h2",
"rid": "abc-567",
"vid": "abc-123"
}
```
_See code: [src/commands/logs/assetLoadTime.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/assetLoadTime.ts)_
## `dog logs:caughtError`
errors your application caught & chose to log
```
USAGE
$ dog logs:caughtError
OPTIONS
-c, --color=color filter by backend color (blue)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:caughtError
# Filter by backend color
$ dog logs:caughtError --color blue
# Pretty print JSON
$ dog logs:caughtError --prettyjson
```
_See code: [src/commands/logs/caughtError.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/caughtError.ts)_
## `dog logs:clientPing`
front end application pings
```
USAGE
$ dog logs:clientPing
OPTIONS
-c, --color=color filter by backend color
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:clientPing
# Filter by backend color
$ dog logs:clientPing --color blue
# Pretty print JSON
$ dog logs:clientPing --prettyjson
```
_See code: [src/commands/logs/clientPing.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/clientPing.ts)_
## `dog logs:error`
errors caught globally from window.onerror
```
USAGE
$ dog logs:error
OPTIONS
-c, --color=color filter by backend color (blue)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:error
# Filter by backend color
$ dog logs:error --color blue
# Pretty print JSON
$ dog logs:error --prettyjson
```
_See code: [src/commands/logs/error.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/error.ts)_
## `dog logs:fps`
instances of client side frames per second dropping below 50 fps
```
USAGE
$ dog logs:fps
OPTIONS
-c, --color=color filter by backend color (blue)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:fps
# Filter by backend color
$ dog logs:fps --color blue
# Pretty print JSON
$ dog logs:fps --prettyjson
```
_See code: [src/commands/logs/fps.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/fps.ts)_
## `dog logs:longTasksTiming`
instances of client side tasks that exceed 50ms using the browsers Long Tasks API
```
USAGE
$ dog logs:longTasksTiming
OPTIONS
-c, --color=color filter by backend color (blue)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:longTasksTiming
# Filter by backend color
$ dog logs:longTasksTiming --color blue
# Pretty print JSON
$ dog logs:longTasksTiming --prettyjson
```
_See code: [src/commands/logs/longTasksTiming.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/longTasksTiming.ts)_
## `dog logs:mouseDistance`
euclidean mouse distance, over 3 second intervals, from your applications
```
USAGE
$ dog logs:mouseDistance
OPTIONS
-p, --prettyjson print pretty JSON
-r, --rid=rid filter by a single rid (get it from server or proxy logs)
EXAMPLE
$ dog logs:mouseDistance
# Filter by a single request Id
$ dog logs:mouseDistance --rid abc-123
# Pretty print JSON
$ dog logs:mouseDistance --prettyjson
```
_See code: [src/commands/logs/mouseDistance.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/mouseDistance.ts)_
## `dog logs:orientationChange`
orientation changes in your application
```
USAGE
$ dog logs:orientationChange
OPTIONS
-p, --prettyjson print pretty JSON
-r, --rid=rid filter by a single rid (get it from server or proxy logs)
EXAMPLE
$ dog logs:orientationChange
# Filter by a single request Id
$ dog logs:orientationChange --rid abc-123
# Pretty print JSON
$ dog logs:orientationChange --prettyjson
```
_See code: [src/commands/logs/orientationChange.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/orientationChange.ts)_
## `dog logs:outcome`
custom implemented outcomes from your application
```
USAGE
$ dog logs:outcome
OPTIONS
-o, --outcome=outcome filter by outcome (addToCart)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:outcome
# Filter by custom outcome (outcomes defined by user)
$ dog logs:outcome --outcome cartAddItem
$ dog logs:outcome --outcome heroImageClick
$ dog logs:outcome --outcome searchAddFilter
# Pretty print JSON
$ dog logs:outcome --prettyjson
```
_See code: [src/commands/logs/outcome.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/outcome.ts)_
## `dog logs:pageScrolling`
scrolling activity from your application
```
USAGE
$ dog logs:pageScrolling
OPTIONS
-n, --pathname=pathname filter by pathname (/pricing)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:pageScrolling
# Filter by pathname
$ dog logs:pageScrolling --pathname /about-us
# Pretty print JSON
$ dog logs:pageScrolling --prettyjson
```
_See code: [src/commands/logs/pageScrolling.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/pageScrolling.ts)_
## `dog logs:pageView`
page views in realtime
```
USAGE
$ dog logs:pageView
OPTIONS
-n, --pathname=pathname filter by pathname (/pricing)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:pageView
# Filter by pathname
$ dog logs:pageView --pathname /about-us
# Pretty print JSON
$ dog logs:pageView --prettyjson
```
_See code: [src/commands/logs/pageView.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/pageView.ts)_
## `dog logs:performanceTiming`
application performance from the navigation timing api including timeToFirstByte, FCP, & TTI
```
USAGE
$ dog logs:performanceTiming
OPTIONS
-p, --prettyjson print pretty JSON
-t, --property=property filter by performance timing property
EXAMPLE
$ dog logs:performanceTiming
# Filter by property
$ dog logs:performanceTiming --property timeToFetchStart
$ dog logs:performanceTiming --property dnsLookupTime
$ dog logs:performanceTiming --property timeToFistByte
$ dog logs:performanceTiming --property timeToHtmlPage
$ dog logs:performanceTiming --property domInteractive
$ dog logs:performanceTiming --property pageLoadTime
$ dog logs:performanceTiming --property firstContentfulPaint
$ dog logs:performanceTiming --property firstPaint
$ dog logs:performanceTiming --property firstInputDelay
$ dog logs:performanceTiming --property tti
# Pretty print JSON
$ dog logs:performanceTiming --prettyjson
```
_See code: [src/commands/logs/performanceTiming.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/performanceTiming.ts)_
## `dog logs:proxyLogs`
proxy logs
```
USAGE
$ dog logs:proxyLogs
OPTIONS
-c, --country=country filter proxy logs by a single country code (such as US)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:proxyLogs
# Filter by country
$ dog logs:proxyLogs --country US
# Pretty print JSON
$ dog logs:proxyLogs --prettyjson
```
_See code: [src/commands/logs/proxyLogs.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/proxyLogs.ts)_
## `dog logs:rapidClicking`
incidences of "rapid/rage clicking" in your application
```
USAGE
$ dog logs:rapidClicking
OPTIONS
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:rapidClicking
# Pretty print JSON
$ dog logs:rapidClicking --prettyjson
```
_See code: [src/commands/logs/rapidClicking.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/rapidClicking.ts)_
## `dog logs:serverLogs`
server logs
```
USAGE
$ dog logs:serverLogs
OPTIONS
-c, --color=color filter by backend color (blue)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:serverLogs
# Filter by color
$ dog logs:serverLogs --color green
# Pretty print JSON
$ dog logs:serverLogs --prettyjson
```
_See code: [src/commands/logs/serverLogs.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/serverLogs.ts)_
## `dog logs:timeOnPage`
time on page activity events (event values are not cumulative)
```
USAGE
$ dog logs:timeOnPage
OPTIONS
-n, --pathname=pathname filter by pathname (/pricing)
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:timeOnPage
# Filter by pathname
$ dog logs:timeOnPage --pathname /about-us
# Pretty print JSON
$ dog logs:timeOnPage --prettyjson
```
_See code: [src/commands/logs/timeOnPage.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/timeOnPage.ts)_
## `dog logs:timeOnSite`
time on site activity events (event values are not cumulative)
```
USAGE
$ dog logs:timeOnSite
OPTIONS
-p, --prettyjson print pretty JSON
-v, --visibility=visibility filter by visibility (hidden)
EXAMPLE
$ dog logs:timeOnSite
# Filter by visibility
$ dog logs:timeOnSite --visibility hidden
# Pretty print JSON
$ dog logs:timeOnSite --prettyjson
```
_See code: [src/commands/logs/timeOnSite.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/timeOnSite.ts)_
## `dog logs:variationInViewport`
variations entering the viewport
```
USAGE
$ dog logs:variationInViewport
OPTIONS
-f, --featureId=featureId filter by featureId
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:variationInViewport
# Filter by featureId
$ dog logs:variationInViewport --featureId abc-123
# Pretty print JSON
$ dog logs:variationInViewport --prettyjson
```
_See code: [src/commands/logs/variationInViewport.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/variationInViewport.ts)_
## `dog logs:variationMousedown`
mousedown events on variations
```
USAGE
$ dog logs:variationMousedown
OPTIONS
-f, --featureId=featureId filter by featureId
-p, --prettyjson print pretty JSON
EXAMPLE
$ dog logs:variationMousedown
# Filter by featureId
$ dog logs:variationMousedown --featureId abc-123
# Pretty print JSON
$ dog logs:variationMousedown --prettyjson
```
_See code: [src/commands/logs/variationMousedown.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/logs/variationMousedown.ts)_
## `dog plugins`
list installed plugins
```
USAGE
$ dog plugins
OPTIONS
--core show core plugins
EXAMPLE
$ dog plugins
```
_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v1.7.8/src/commands/plugins/index.ts)_
## `dog plugins:install PLUGIN...`
installs a plugin into the CLI
```
USAGE
$ dog plugins:install PLUGIN...
ARGUMENTS
PLUGIN plugin to install
OPTIONS
-f, --force yarn install with force flag
-h, --help show CLI help
-v, --verbose
DESCRIPTION
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
$ dog plugins:add
EXAMPLES
$ dog plugins:install myplugin
$ dog plugins:install https://github.com/someuser/someplugin
$ dog plugins:install someuser/someplugin
```
_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v1.7.8/src/commands/plugins/install.ts)_
## `dog plugins:link PLUGIN`
links a plugin into the CLI for development
```
USAGE
$ dog plugins:link PLUGIN
ARGUMENTS
PATH [default: .] path to plugin
OPTIONS
-h, --help show CLI help
-v, --verbose
DESCRIPTION
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.
EXAMPLE
$ dog plugins:link myplugin
```
_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v1.7.8/src/commands/plugins/link.ts)_
## `dog plugins:uninstall PLUGIN...`
removes a plugin from the CLI
```
USAGE
$ dog plugins:uninstall PLUGIN...
ARGUMENTS
PLUGIN plugin to uninstall
OPTIONS
-h, --help show CLI help
-v, --verbose
ALIASES
$ dog plugins:unlink
$ dog plugins:remove
```
_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v1.7.8/src/commands/plugins/uninstall.ts)_
## `dog plugins:update`
update installed plugins
```
USAGE
$ dog plugins:update
OPTIONS
-h, --help show CLI help
-v, --verbose
```
_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v1.7.8/src/commands/plugins/update.ts)_
## `dog proxy:abtest`
deploy a/b/n tests across any number of origins
```
USAGE
$ dog proxy:abtest
OPTIONS
-o, --origin=origin (required) FQDN for an A/B test backend or a valid deployed color
EXAMPLE
# A/B test between your blue and green backends
$ dog proxy:abtest --origin blue --origin green
# A/B test between your blue backend and example.com
$ dog proxy:abtest --origin blue --origin https://www.example.com
# A/B test between 3 origins
$ dog proxy:abtest -o blue -o green -o https://www.example.com
# A/B test between 4 origins
$ dog proxy:abtest -o blue -o green -o https://www.example.com -o https://www.digitaloptgroup.com
```
_See code: [src/commands/proxy/abtest.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/proxy/abtest.ts)_
## `dog proxy:apply`
update your production proxy
```
USAGE
$ dog proxy:apply
OPTIONS
-f, --force
```
_See code: [src/commands/proxy/apply.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/proxy/apply.ts)_
## `dog proxy:canary`
run and manage canary releases
```
USAGE
$ dog proxy:canary
OPTIONS
-c, --canary=canary (required) FQDN for an canary backend or a valid deployed color
-p, --production=production (required) FQDN for production backend or a valid deployed color
-w, --weight=weight (required) an integer between 1 and 100 that will equal the percentage of traffic sent to
the canary
--force force the proxy config to do something that it not recommended
--reassign forces a new salt to be created and all currently assigned visitors to be reallocated to
a random backend - not recommended
EXAMPLE
# Send 20% of your traffic to your green backend as a canary
$ dog proxy:canary --production blue --canary green --weight 20
# Increase to 50% of your traffic to your green backend
$ dog proxy:canary -p blue -c green -w 50
# Increase to 75% of your traffic to your green backend
$ dog proxy:canary -p blue -c green -w 75
# Force reassignment of all visitors on both backends (advanced - not recommended)
$ dog proxy:canary -p blue -c green -w 50 --reassign
# Decrease traffic allocated to canary backend (advanced - not recommended)
$ dog proxy:canary -p blue -c green -w 5 --force
```
_See code: [src/commands/proxy/canary.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/proxy/canary.ts)_
## `dog proxy:gatekeep ORIGIN`
create a gatekeeping url to any given origin
```
USAGE
$ dog proxy:gatekeep ORIGIN
ARGUMENTS
ORIGIN a valid deployed color or a fully qualified domain name
OPTIONS
--cmsPreview
EXAMPLE
$ dog proxy:gatekeep blue
# Gatekeep and open preview mode of the CMS
$ dog proxy:gatekeep blue --cmsPreview
# Gatekeep to any FQDN on the internet
$ dog proxy:gatekeep https://www.example.com
```
_See code: [src/commands/proxy/gatekeep.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/proxy/gatekeep.ts)_
## `dog proxy:localhost [PORT]`
(experimental) create a gatekeeping url that tunnels to your local development server
```
USAGE
$ dog proxy:localhost [PORT]
ARGUMENTS
PORT [default: 3000] the port of your local server
OPTIONS
-c, --cmsPreview include realtime preview mode in created link
EXAMPLE
$ dog proxy:localhost
# Tunnel to a custom port (default 3000)
$ dog proxy:localhost 3001
# Include preview mode of the CMS
$ dog proxy:localhost 3001 --cmsPreview
```
_See code: [src/commands/proxy/localhost.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/proxy/localhost.ts)_
## `dog proxy:prod PRODUCTIONBACKEND`
set your local proxy config to a single production backend
```
USAGE
$ dog proxy:prod PRODUCTIONBACKEND
ARGUMENTS
PRODUCTIONBACKEND a valid deployed color or a fully qualified domain name to set as your single production backend
EXAMPLE
$ dog proxy:prod blue
# Set any FQDN as the production backend
$ dog proxy:prod https://www.example.com
```
_See code: [src/commands/proxy/prod.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/proxy/prod.ts)_
## `dog proxy:refresh`
refresh your local config from production environment
```
USAGE
$ dog proxy:refresh
```
_See code: [src/commands/proxy/refresh.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/proxy/refresh.ts)_
## `dog proxy:rollback`
rollback proxy to a prior deployment
```
USAGE
$ dog proxy:rollback
```
_See code: [src/commands/proxy/rollback.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/proxy/rollback.ts)_
## `dog proxy:show`
show current local & deployed proxy configs
```
USAGE
$ dog proxy:show
```
_See code: [src/commands/proxy/show.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/proxy/show.ts)_
## `dog share`
create invite link/code for developer preview (allows someone else to create their own account)
```
USAGE
$ dog share
```
_See code: [src/commands/share.ts](https://github.com/DigitalOptGroup/dogcli/blob/v0.0.1-dev-preview-36/src/commands/share.ts)_
## `dog start`
run a local server for development
```
USAGE
$ dog start
OPTIONS
-p, --port=port
-s, --script=script
```
_See code: [@digitaloptgroup/plugin-install-start](https://github.com/DigitalOptGroup/plugin-install-start/blob/v0.0.1-devpreview-02/src/commands/start.ts)_