@chabokan.net/cli 0.8.10 → 0.9.0

package/README.md

@@ -1,18 +1,50 @@
 chabok
 =================
 
-A new CLI generated with oclif
-
+Deploy and manage your [Chabokan](https://chabokan.net) services from the terminal.
 
+[![Version](https://img.shields.io/npm/v/@chabokan.net/cli.svg)](https://npmjs.org/package/@chabokan.net/cli)
+[![Downloads/week](https://img.shields.io/npm/dw/@chabokan.net/cli.svg)](https://npmjs.org/package/@chabokan.net/cli)
 [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
-[![Version](https://img.shields.io/npm/v/chabok.svg)](https://npmjs.org/package/chabok)
-[![Downloads/week](https://img.shields.io/npm/dw/chabok.svg)](https://npmjs.org/package/chabok)
-
 
 <!-- toc -->
+* [Quick start](#quick-start)
 * [Usage](#usage)
+* [Environment variables](#environment-variables)
 * [Commands](#commands)
 <!-- tocstop -->
+# Quick start
+
+```sh
+  # 1. Install
+  npm install -g @chabokan.net/cli
+
+  # 2. Sign in (or use an API token: chabok login -t <token>)
+  chabok login
+
+  # 3. See what you have
+  chabok service list
+
+  # 4. Deploy the project in the current directory
+  cd my-project
+  chabok deploy
+```
+
+To deploy the same project repeatedly without picking the service each time, add a
+`chabok.json` to its root:
+
+```json
+{
+  "service": "my-app"
+}
+```
+
+Then `chabok deploy` alone is enough.
+
+Files are excluded from the upload using `.chabokignore`, falling back to
+`.dockerignore` and then `.gitignore`. Run with `CHABOK_DEBUG=true` to see exactly
+what was skipped.
+
 # Usage
 <!-- usage -->
 ```sh-session
@@ -20,19 +52,44 @@ $ npm install -g @chabokan.net/cli
 $ chabok COMMAND
 running command...
 $ chabok (--version|-v)
-@chabokan.net/cli/0.8.10 darwin-arm64 node-v20.13.1
+@chabokan.net/cli/0.9.0 darwin-arm64 node-v20.13.1
 $ chabok --help [COMMAND]
 USAGE
   $ chabok COMMAND
 ...
 ```
 <!-- usagestop -->
+# Environment variables
+
+| Variable | Description |
+| --- | --- |
+| `CHABOK_DEBUG` | Set to `true` to print full error details (status code, endpoint, error code, response body) and ignored-file logs during deploy. |
+| `CHABOK_API_URL` | Override the API base URL. Defaults to `https://apihub.chabokan.net/fa/api/v1/`. |
+| `CHABOK_INSECURE_TLS` | Set to `true` to skip TLS certificate verification. Only for servers with a self-signed certificate — it disables protection against interception, so the CLI warns whenever it is active. |
+| `CHABOK_NO_UPDATE_CHECK` | Set to any value to disable the "new version available" check entirely. Also honours `NO_UPDATE_NOTIFIER`, and it is skipped automatically when `CI` is set. |
+| `CHABOK_NPM_REGISTRY` | npm registry used for the update check. Defaults to `https://registry.npmjs.org`. |
+| `http_proxy` / `https_proxy` | Route requests through an HTTP proxy. |
+
+Credentials are stored in `~/.chabok.json` with `0600` permissions (readable only by you).
+
+The update check is designed to stay out of your way: it contacts the registry at
+most once every 24 hours, gives up after 1.5 seconds, writes its notice to stderr
+so it never pollutes piped output, and stays silent on any failure. If you are
+offline it costs one 1.5s timeout, and nothing at all on subsequent runs.
+
 # Commands
 <!-- commands -->
+* [`chabok account info`](#chabok-account-info)
 * [`chabok account list`](#chabok-account-list)
 * [`chabok account remove`](#chabok-account-remove)
 * [`chabok account use`](#chabok-account-use)
 * [`chabok autocomplete [SHELL]`](#chabok-autocomplete-shell)
+* [`chabok cloudserver create`](#chabok-cloudserver-create)
+* [`chabok cloudserver delete`](#chabok-cloudserver-delete)
+* [`chabok cloudserver list`](#chabok-cloudserver-list)
+* [`chabok cloudserver restart`](#chabok-cloudserver-restart)
+* [`chabok cloudserver start`](#chabok-cloudserver-start)
+* [`chabok cloudserver stop`](#chabok-cloudserver-stop)
 * [`chabok deploy`](#chabok-deploy)
 * [`chabok help [COMMAND]`](#chabok-help-command)
 * [`chabok login`](#chabok-login)
@@ -46,6 +103,8 @@ USAGE
 * [`chabok plugins uninstall [PLUGIN]`](#chabok-plugins-uninstall-plugin)
 * [`chabok plugins unlink [PLUGIN]`](#chabok-plugins-unlink-plugin)
 * [`chabok plugins update`](#chabok-plugins-update)
+* [`chabok service domain add`](#chabok-service-domain-add)
+* [`chabok service domain remove`](#chabok-service-domain-remove)
 * [`chabok service list`](#chabok-service-list)
 * [`chabok service logs`](#chabok-service-logs)
 * [`chabok service resize`](#chabok-service-resize)
@@ -53,10 +112,33 @@ USAGE
 * [`chabok service start`](#chabok-service-start)
 * [`chabok service stop`](#chabok-service-stop)
 * [`chabok version`](#chabok-version)
+* [`chabok wallet list`](#chabok-wallet-list)
+
+## `chabok account info`
+
+show information about the active account
+
+```
+USAGE
+  $ chabok account info [-h]
+
+FLAGS
+  -h, --help  Show CLI help.
+
+DESCRIPTION
+  show information about the active account
+
+EXAMPLES
+  Show the active account's details
+
+    $ chabok account info
+```
+
+_See code: [src/commands/account/info.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/account/info.ts)_
 
 ## `chabok account list`
 
-show accounts list
+list the accounts you are logged in to
 
 ```
 USAGE
@@ -66,14 +148,19 @@ FLAGS
   -h, --help  Show CLI help.
 
 DESCRIPTION
-  show accounts list
+  list the accounts you are logged in to
+
+EXAMPLES
+  Show every logged-in account and which one is active
+
+    $ chabok account list
 ```
 
-_See code: [src/commands/account/list.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/account/list.ts)_
+_See code: [src/commands/account/list.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/account/list.ts)_
 
 ## `chabok account remove`
 
-remove account from list
+sign out of an account and forget its stored token
 
 ```
 USAGE
@@ -83,14 +170,19 @@ FLAGS
   -h, --help  Show CLI help.
 
 DESCRIPTION
-  remove account from list
+  sign out of an account and forget its stored token
+
+EXAMPLES
+  Pick the account to sign out of
+
+    $ chabok account remove
 ```
 
-_See code: [src/commands/account/remove.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/account/remove.ts)_
+_See code: [src/commands/account/remove.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/account/remove.ts)_
 
 ## `chabok account use`
 
-switch your default user between logged in users
+switch the active account
 
 ```
 USAGE
@@ -98,13 +190,22 @@ USAGE
 
 FLAGS
   -h, --help          Show CLI help.
-  -u, --user=<value>  default user
+  -u, --user=<value>  email of the account to switch to
 
 DESCRIPTION
-  switch your default user between logged in users
+  switch the active account
+
+EXAMPLES
+  Pick the account to switch to from a list
+
+    $ chabok account use
+
+  Switch to a specific account without prompting
+
+    $ chabok account use --user me@example.com
 ```
 
-_See code: [src/commands/account/use.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/account/use.ts)_
+_See code: [src/commands/account/use.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/account/use.ts)_
 
 ## `chabok autocomplete [SHELL]`
 
@@ -115,7 +216,7 @@ USAGE
   $ chabok autocomplete [SHELL] [-r]
 
 ARGUMENTS
-  SHELL  (zsh|bash|powershell) Shell type
+  [SHELL]  (zsh|bash|powershell) Shell type
 
 FLAGS
   -r, --refresh-cache  Refresh cache (ignores displaying instructions)
@@ -135,11 +236,170 @@ EXAMPLES
   $ chabok autocomplete --refresh-cache
 ```
 
-_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.2.31/src/commands/autocomplete/index.ts)_
+_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.2.53/src/commands/autocomplete/index.ts)_
+
+## `chabok cloudserver create`
+
+create a new cloud server (VPS) — walks through provider, location, plan, OS and wallet
+
+```
+USAGE
+  $ chabok cloudserver create [-h] [--hostname <value>] [--wallet <value>]
+
+FLAGS
+  -h, --help              Show CLI help.
+      --hostname=<value>  hostname for the new cloud server
+      --wallet=<value>    name of the wallet to pay from
+
+DESCRIPTION
+  create a new cloud server (VPS) — walks through provider, location, plan, OS and wallet
+
+EXAMPLES
+  Create a cloud server, choosing every option interactively
+
+    $ chabok cloudserver create
+
+  Skip the hostname prompt
+
+    $ chabok cloudserver create --hostname my-vps
+```
+
+_See code: [src/commands/cloudserver/create.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/cloudserver/create.ts)_
+
+## `chabok cloudserver delete`
+
+permanently delete a cloud server
+
+```
+USAGE
+  $ chabok cloudserver delete [-h] [--hostname <value>] [-y]
+
+FLAGS
+  -h, --help              Show CLI help.
+  -y, --yes               skip the confirmation prompt
+      --hostname=<value>  hostname of the cloud server to delete
+
+DESCRIPTION
+  permanently delete a cloud server
+
+EXAMPLES
+  Pick a cloud server from an interactive list, then confirm
+
+    $ chabok cloudserver delete
+
+  Delete a specific cloud server without a confirmation prompt
+
+    $ chabok cloudserver delete --hostname my-vps --yes
+```
+
+_See code: [src/commands/cloudserver/delete.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/cloudserver/delete.ts)_
+
+## `chabok cloudserver list`
+
+list the cloud servers (VPS) on your account
+
+```
+USAGE
+  $ chabok cloudserver list [-h]
+
+FLAGS
+  -h, --help  Show CLI help.
+
+DESCRIPTION
+  list the cloud servers (VPS) on your account
+
+EXAMPLES
+  List every cloud server on the active account
+
+    $ chabok cloudserver list
+```
+
+_See code: [src/commands/cloudserver/list.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/cloudserver/list.ts)_
+
+## `chabok cloudserver restart`
+
+restart a cloud server
+
+```
+USAGE
+  $ chabok cloudserver restart [-h] [--hostname <value>]
+
+FLAGS
+  -h, --help              Show CLI help.
+      --hostname=<value>  hostname of the cloud server to restart
+
+DESCRIPTION
+  restart a cloud server
+
+EXAMPLES
+  Pick a cloud server from an interactive list
+
+    $ chabok cloudserver restart
+
+  Restart a specific cloud server by hostname
+
+    $ chabok cloudserver restart --hostname my-vps
+```
+
+_See code: [src/commands/cloudserver/restart.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/cloudserver/restart.ts)_
+
+## `chabok cloudserver start`
+
+turn on a cloud server
+
+```
+USAGE
+  $ chabok cloudserver start [-h] [--hostname <value>]
+
+FLAGS
+  -h, --help              Show CLI help.
+      --hostname=<value>  hostname of the cloud server to turn on
+
+DESCRIPTION
+  turn on a cloud server
+
+EXAMPLES
+  Pick a cloud server from an interactive list
+
+    $ chabok cloudserver start
+
+  Turn on a specific cloud server by hostname
+
+    $ chabok cloudserver start --hostname my-vps
+```
+
+_See code: [src/commands/cloudserver/start.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/cloudserver/start.ts)_
+
+## `chabok cloudserver stop`
+
+turn off a cloud server
+
+```
+USAGE
+  $ chabok cloudserver stop [-h] [--hostname <value>]
+
+FLAGS
+  -h, --help              Show CLI help.
+      --hostname=<value>  hostname of the cloud server to turn off
+
+DESCRIPTION
+  turn off a cloud server
+
+EXAMPLES
+  Pick a cloud server from an interactive list
+
+    $ chabok cloudserver stop
+
+  Turn off a specific cloud server by hostname
+
+    $ chabok cloudserver stop --hostname my-vps
+```
+
+_See code: [src/commands/cloudserver/stop.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/cloudserver/stop.ts)_
 
 ## `chabok deploy`
 
-this command help you build and deploy your service to chabokan in easy way.
+upload the current project and deploy it to a service
 
 ```
 USAGE
@@ -147,14 +407,35 @@ USAGE
 
 FLAGS
   -h, --help             Show CLI help.
-  -p, --path=<value>     service path in your computer
-  -s, --service=<value>  service name
+  -p, --path=<value>     project directory to upload (defaults to the current directory)
+  -s, --service=<value>  name of the service to deploy to
 
 DESCRIPTION
-  this command help you build and deploy your service to chabokan in easy way.
+  upload the current project and deploy it to a service
+
+EXAMPLES
+  Deploy the current directory, picking the service from a list
+
+    $ chabok deploy
+
+  Deploy the current directory to a named service
+
+    $ chabok deploy --service my-app
+
+  Deploy a project that lives somewhere else
+
+    $ chabok deploy --path ./apps/api --service my-api
+
+  Pin the target service in the project, so plain `deploy` always works
+
+    echo '{"service": "my-app"}' > chabok.json && chabok deploy
+
+  See exactly which files are excluded from the upload
+
+    CHABOK_DEBUG=true chabok deploy -s my-app
 ```
 
-_See code: [src/commands/deploy.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/deploy.ts)_
+_See code: [src/commands/deploy.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/deploy.ts)_
 
 ## `chabok help [COMMAND]`
 
@@ -165,7 +446,7 @@ USAGE
   $ chabok help [COMMAND...] [-n]
 
 ARGUMENTS
-  COMMAND...  Command to show help for.
+  [COMMAND...]  Command to show help for.
 
 FLAGS
   -n, --nested-commands  Include all nested commands in the output.
@@ -174,11 +455,11 @@ DESCRIPTION
   Display help for chabok.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.29/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.53/src/commands/help.ts)_
 
 ## `chabok login`
 
-login to hub.chabokan.net account
+sign in to your hub.chabokan.net account
 
 ```
 USAGE
@@ -186,15 +467,32 @@ USAGE
 
 FLAGS
   -h, --help              Show CLI help.
-  -p, --password=<value>  your password
-  -t, --token=<value>     login with api token
-  -u, --username=<value>  your username
+  -p, --password=<value>  your password (prompted for if omitted)
+  -t, --token=<value>     API token, for non-interactive sign-in
+  -u, --username=<value>  your email address
 
 DESCRIPTION
-  login to hub.chabokan.net account
+  sign in to your hub.chabokan.net account
+
+EXAMPLES
+  Sign in interactively (prompts for email and password)
+
+    $ chabok login
+
+  Sign in with an API token — the right choice for CI
+
+    $ chabok login --token <your-api-token>
+
+  Pass the email up front and be prompted only for the password
+
+    $ chabok login --email me@example.com
+
+  Add a second account (both stay signed in; switch with `account use`)
+
+    $ chabok login --email other@example.com
 ```
 
-_See code: [src/commands/login.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/login.ts)_
 
 ## `chabok plugins`
 
@@ -217,7 +515,7 @@ EXAMPLES
   $ chabok plugins
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.43/src/commands/plugins/index.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.85/src/commands/plugins/index.ts)_
 
 ## `chabok plugins add PLUGIN`
 
@@ -291,7 +589,7 @@ EXAMPLES
   $ chabok plugins inspect myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.43/src/commands/plugins/inspect.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.85/src/commands/plugins/inspect.ts)_
 
 ## `chabok plugins install PLUGIN`
 
@@ -340,7 +638,7 @@ EXAMPLES
     $ chabok plugins install someuser/someplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.43/src/commands/plugins/install.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.85/src/commands/plugins/install.ts)_
 
 ## `chabok plugins link PATH`
 
@@ -371,7 +669,7 @@ EXAMPLES
   $ chabok plugins link myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.43/src/commands/plugins/link.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.85/src/commands/plugins/link.ts)_
 
 ## `chabok plugins remove [PLUGIN]`
 
@@ -382,7 +680,7 @@ USAGE
   $ chabok plugins remove [PLUGIN...] [-h] [-v]
 
 ARGUMENTS
-  PLUGIN...  plugin to uninstall
+  [PLUGIN...]  plugin to uninstall
 
 FLAGS
   -h, --help     Show CLI help.
@@ -412,7 +710,7 @@ FLAGS
   --reinstall  Reinstall all plugins after uninstalling.
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.43/src/commands/plugins/reset.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.85/src/commands/plugins/reset.ts)_
 
 ## `chabok plugins uninstall [PLUGIN]`
 
@@ -423,7 +721,7 @@ USAGE
   $ chabok plugins uninstall [PLUGIN...] [-h] [-v]
 
 ARGUMENTS
-  PLUGIN...  plugin to uninstall
+  [PLUGIN...]  plugin to uninstall
 
 FLAGS
   -h, --help     Show CLI help.
@@ -440,7 +738,7 @@ EXAMPLES
   $ chabok plugins uninstall myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.43/src/commands/plugins/uninstall.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.85/src/commands/plugins/uninstall.ts)_
 
 ## `chabok plugins unlink [PLUGIN]`
 
@@ -451,7 +749,7 @@ USAGE
   $ chabok plugins unlink [PLUGIN...] [-h] [-v]
 
 ARGUMENTS
-  PLUGIN...  plugin to uninstall
+  [PLUGIN...]  plugin to uninstall
 
 FLAGS
   -h, --help     Show CLI help.
@@ -484,11 +782,67 @@ DESCRIPTION
   Update installed plugins.
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.43/src/commands/plugins/update.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.85/src/commands/plugins/update.ts)_
+
+## `chabok service domain add`
+
+connect a custom domain to a service
+
+```
+USAGE
+  $ chabok service domain add [-h] [-s <value>] [-d <value>]
+
+FLAGS
+  -d, --domain=<value>   domain name to connect, e.g. www.example.com
+  -h, --help             Show CLI help.
+  -s, --service=<value>  name of the service to connect the domain to
+
+DESCRIPTION
+  connect a custom domain to a service
+
+EXAMPLES
+  Pick the service and enter the domain interactively
+
+    $ chabok service domain add
+
+  Connect a domain in one non-interactive command
+
+    $ chabok service domain add -s my-app -d www.example.com
+```
+
+_See code: [src/commands/service/domain/add.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/service/domain/add.ts)_
+
+## `chabok service domain remove`
+
+disconnect a custom domain from a service
+
+```
+USAGE
+  $ chabok service domain remove [-h] [-s <value>] [-d <value>]
+
+FLAGS
+  -d, --domain=<value>   domain name to disconnect
+  -h, --help             Show CLI help.
+  -s, --service=<value>  name of the service the domain is connected to
+
+DESCRIPTION
+  disconnect a custom domain from a service
+
+EXAMPLES
+  Pick the service and enter the domain interactively
+
+    $ chabok service domain remove
+
+  Disconnect a domain in one non-interactive command
+
+    $ chabok service domain remove -s my-app -d www.example.com
+```
+
+_See code: [src/commands/service/domain/remove.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/service/domain/remove.ts)_
 
 ## `chabok service list`
 
-show account services list
+list the services on your account
 
 ```
 USAGE
@@ -498,14 +852,23 @@ FLAGS
   -h, --help  Show CLI help.
 
 DESCRIPTION
-  show account services list
+  list the services on your account
+
+EXAMPLES
+  List every service on the active account
+
+    $ chabok service list
+
+  Switch account first, then list that account’s services
+
+    $ chabok account use -u me@example.com && chabok service list
 ```
 
-_See code: [src/commands/service/list.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/service/list.ts)_
+_See code: [src/commands/service/list.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/service/list.ts)_
 
 ## `chabok service logs`
 
-read latest logs from service
+read the latest logs from a service
 
 ```
 USAGE
@@ -513,34 +876,64 @@ USAGE
 
 FLAGS
   -h, --help             Show CLI help.
-  -s, --service=<value>  service name
+  -s, --service=<value>  name of the service to read logs from
 
 DESCRIPTION
-  read latest logs from service
+  read the latest logs from a service
+
+EXAMPLES
+  Pick a service from an interactive list
+
+    $ chabok service logs
+
+  Read logs for a specific service
+
+    $ chabok service logs --service my-app
+
+  Search the logs for errors
+
+    $ chabok service logs -s my-app | grep -i error
+
+  Save the logs to a file
+
+    $ chabok service logs -s my-app > my-app.log
 ```
 
-_See code: [src/commands/service/logs.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/service/logs.ts)_
+_See code: [src/commands/service/logs.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/service/logs.ts)_
 
 ## `chabok service resize`
 
-resize a service
+change the RAM, CPU and disk allocated to a service
 
 ```
 USAGE
   $ chabok service resize [-h] [-s <value>] [-r <value>] [-c <value>] [-d <value>]
 
 FLAGS
-  -c, --cpu=<value>      CPU
-  -d, --disk=<value>     DISK
+  -c, --cpu=<value>      CPU cores, in steps of 0.5 (e.g. 0.5, 1, 2)
+  -d, --disk=<value>     disk in GB, in steps of 5 (e.g. 5, 10, 30)
   -h, --help             Show CLI help.
-  -r, --ram=<value>      RAM
-  -s, --service=<value>  service name
+  -r, --ram=<value>      RAM in GB, in steps of 0.5 (e.g. 0.5, 1, 2)
+  -s, --service=<value>  name of the service to resize
 
 DESCRIPTION
-  resize a service
+  change the RAM, CPU and disk allocated to a service
+
+EXAMPLES
+  Choose the service and every resource interactively
+
+    $ chabok service resize
+
+  Resize a service in one non-interactive command
+
+    $ chabok service resize -s my-app --ram 2 --cpu 1 --disk 10
+
+  Set only the RAM and pick the rest from the prompts
+
+    $ chabok service resize -s my-app --ram 4
 ```
 
-_See code: [src/commands/service/resize.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/service/resize.ts)_
+_See code: [src/commands/service/resize.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/service/resize.ts)_
 
 ## `chabok service restart`
 
@@ -552,17 +945,30 @@ USAGE
 
 FLAGS
   -h, --help             Show CLI help.
-  -s, --service=<value>  service name
+  -s, --service=<value>  name of the service to restart
 
 DESCRIPTION
   restart a service
+
+EXAMPLES
+  Pick a service from an interactive list
+
+    $ chabok service restart
+
+  Restart a specific service by name
+
+    $ chabok service restart --service my-app
+
+  Restart, then tail the logs to confirm it came back up
+
+    $ chabok service restart -s my-app && chabok service logs -s my-app
 ```
 
-_See code: [src/commands/service/restart.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/service/restart.ts)_
+_See code: [src/commands/service/restart.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/service/restart.ts)_
 
 ## `chabok service start`
 
-start a service
+start a stopped service
 
 ```
 USAGE
@@ -570,17 +976,30 @@ USAGE
 
 FLAGS
   -h, --help             Show CLI help.
-  -s, --service=<value>  service name
+  -s, --service=<value>  name of the service to start
 
 DESCRIPTION
-  start a service
+  start a stopped service
+
+EXAMPLES
+  Pick a service from an interactive list
+
+    $ chabok service start
+
+  Start a specific service by name
+
+    $ chabok service start --service my-app
+
+  Same, using the short flag
+
+    $ chabok service start -s my-app
 ```
 
-_See code: [src/commands/service/start.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/service/start.ts)_
+_See code: [src/commands/service/start.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/service/start.ts)_
 
 ## `chabok service stop`
 
-stop a service
+stop a running service
 
 ```
 USAGE
@@ -588,13 +1007,26 @@ USAGE
 
 FLAGS
   -h, --help             Show CLI help.
-  -s, --service=<value>  service name
+  -s, --service=<value>  name of the service to stop
 
 DESCRIPTION
-  stop a service
+  stop a running service
+
+EXAMPLES
+  Pick a service from an interactive list
+
+    $ chabok service stop
+
+  Stop a specific service by name
+
+    $ chabok service stop --service my-app
+
+  Same, using the short flag
+
+    $ chabok service stop -s my-app
 ```
 
-_See code: [src/commands/service/stop.ts](https://github.com/chabokan/cli/blob/v0.8.10/src/commands/service/stop.ts)_
+_See code: [src/commands/service/stop.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/service/stop.ts)_
 
 ## `chabok version`
 
@@ -614,5 +1046,27 @@ FLAG DESCRIPTIONS
     Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.
 ```
 
-_See code: [@oclif/plugin-version](https://github.com/oclif/plugin-version/blob/v2.2.30/src/commands/version.ts)_
+_See code: [@oclif/plugin-version](https://github.com/oclif/plugin-version/blob/2.2.51/src/commands/version.ts)_
+
+## `chabok wallet list`
+
+list the wallets on your account
+
+```
+USAGE
+  $ chabok wallet list [-h]
+
+FLAGS
+  -h, --help  Show CLI help.
+
+DESCRIPTION
+  list the wallets on your account
+
+EXAMPLES
+  Show every wallet and its balance
+
+    $ chabok wallet list
+```
+
+_See code: [src/commands/wallet/list.ts](https://github.com/chabokan/cli/blob/v0.9.0/src/commands/wallet/list.ts)_
 <!-- commandsstop -->