hereya-cli 0.87.0 → 0.89.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.87.0 linux-x64 node-v24.14.1
+hereya-cli/0.89.0 linux-x64 node-v24.14.1
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -66,9 +66,9 @@ USAGE
 * [`hereya flow remove PACKAGE`](#hereya-flow-remove-package)
 * [`hereya flow run CMD`](#hereya-flow-run-cmd)
 * [`hereya flow up`](#hereya-flow-up)
-* [`hereya git`](#hereya-git)
 * [`hereya help [COMMAND]`](#hereya-help-command)
 * [`hereya import PACKAGE`](#hereya-import-package)
+* [`hereya import-repo PROJECT`](#hereya-import-repo-project)
 * [`hereya init PROJECT`](#hereya-init-project)
 * [`hereya list`](#hereya-list)
 * [`hereya login [URL]`](#hereya-login-url)
@@ -128,7 +128,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/add/index.ts)_
 
 ## `hereya app deploy NAME`
 
@@ -136,8 +136,7 @@ Deploy a hereya-app to a workspace.
 
 ```
 USAGE
-  $ hereya app deploy NAME -w <value> [--chdir <value>] [--local] [-p <value>...] [--token <value>] [--version
-    <value>]
+  $ hereya app deploy NAME -w <value> [--chdir <value>] [--local] [-p <value>...] [--version <value>]
 
 ARGUMENTS
   NAME  app name in org/name format
@@ -150,9 +149,6 @@ FLAGS
                               Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR
                               environment variable.
       --local                 force local execution (skip remote executor)
-      --token=<value>         Ephemeral cloud access token used for this invocation only. Held in memory; never written
-                              to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN
-                              environment variable.
       --version=<value>       specific app version to deploy (defaults to latest)
 
 DESCRIPTION
@@ -166,7 +162,7 @@ EXAMPLES
   $ hereya app deploy my-org/my-app -w prod -p organizationId=org-123
 ```
 
-_See code: [src/commands/app/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/app/deploy/index.ts)_
+_See code: [src/commands/app/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/app/deploy/index.ts)_
 
 ## `hereya app deployments NAME`
 
@@ -174,15 +170,11 @@ List workspaces a hereya-app has been deployed to.
 
 ```
 USAGE
-  $ hereya app deployments NAME [--token <value>]
+  $ hereya app deployments NAME
 
 ARGUMENTS
   NAME  app name in org/name format
 
-FLAGS
-  --token=<value>  Ephemeral cloud access token used for this invocation only. Held in memory; never written to the
-                   keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.
-
 DESCRIPTION
   List workspaces a hereya-app has been deployed to.
 
@@ -190,7 +182,7 @@ EXAMPLES
   $ hereya app deployments my-org/my-app
 ```
 
-_See code: [src/commands/app/deployments/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/app/deployments/index.ts)_
+_See code: [src/commands/app/deployments/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/app/deployments/index.ts)_
 
 ## `hereya app destroy NAME`
 
@@ -198,7 +190,7 @@ Destroy a hereya-app deployment from a workspace.
 
 ```
 USAGE
-  $ hereya app destroy NAME -w <value> [--chdir <value>] [--local] [-p <value>...] [--token <value>]
+  $ hereya app destroy NAME -w <value> [--chdir <value>] [--local] [-p <value>...]
 
 ARGUMENTS
   NAME  app name in org/name format
@@ -211,9 +203,6 @@ FLAGS
                               Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR
                               environment variable.
       --local                 force local execution (skip remote executor)
-      --token=<value>         Ephemeral cloud access token used for this invocation only. Held in memory; never written
-                              to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN
-                              environment variable.
 
 DESCRIPTION
   Destroy a hereya-app deployment from a workspace.
@@ -222,7 +211,7 @@ EXAMPLES
   $ hereya app destroy my-org/my-app -w my-workspace
 ```
 
-_See code: [src/commands/app/destroy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/app/destroy/index.ts)_
+_See code: [src/commands/app/destroy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/app/destroy/index.ts)_
 
 ## `hereya app env NAME [KEY]`
 
@@ -230,7 +219,7 @@ Print environment variables exported by a hereya-app deployment.
 
 ```
 USAGE
-  $ hereya app env NAME [KEY] -w <value> [--token <value>]
+  $ hereya app env NAME [KEY] -w <value>
 
 ARGUMENTS
   NAME  app name in org/name format
@@ -238,9 +227,6 @@ ARGUMENTS
 
 FLAGS
   -w, --workspace=<value>  (required) workspace to read env outputs from
-      --token=<value>      Ephemeral cloud access token used for this invocation only. Held in memory; never written to
-                           the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment
-                           variable.
 
 DESCRIPTION
   Print environment variables exported by a hereya-app deployment.
@@ -251,7 +237,7 @@ EXAMPLES
   $ hereya app env my-org/my-app -w my-workspace DATABASE_URL
 ```
 
-_See code: [src/commands/app/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/app/env/index.ts)_
+_See code: [src/commands/app/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/app/env/index.ts)_
 
 ## `hereya app list`
 
@@ -259,11 +245,7 @@ List hereya-apps available to your account.
 
 ```
 USAGE
-  $ hereya app list [--token <value>]
-
-FLAGS
-  --token=<value>  Ephemeral cloud access token used for this invocation only. Held in memory; never written to the
-                   keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.
+  $ hereya app list
 
 DESCRIPTION
   List hereya-apps available to your account.
@@ -272,7 +254,7 @@ EXAMPLES
   $ hereya app list
 ```
 
-_See code: [src/commands/app/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/app/list/index.ts)_
+_See code: [src/commands/app/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/app/list/index.ts)_
 
 ## `hereya app new DIRNAME`
 
@@ -298,7 +280,7 @@ EXAMPLES
   $ hereya app new ./my-app -n my-org/my-app --description "An ai-app-builder app"
 ```
 
-_See code: [src/commands/app/new/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/app/new/index.ts)_
+_See code: [src/commands/app/new/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/app/new/index.ts)_
 
 ## `hereya app status NAME`
 
@@ -306,16 +288,13 @@ Show the deployment status of a hereya-app on a workspace.
 
 ```
 USAGE
-  $ hereya app status NAME -w <value> [--token <value>]
+  $ hereya app status NAME -w <value>
 
 ARGUMENTS
   NAME  app name in org/name format
 
 FLAGS
   -w, --workspace=<value>  (required) workspace to read deployment status from
-      --token=<value>      Ephemeral cloud access token used for this invocation only. Held in memory; never written to
-                           the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment
-                           variable.
 
 DESCRIPTION
   Show the deployment status of a hereya-app on a workspace.
@@ -324,7 +303,7 @@ EXAMPLES
   $ hereya app status my-org/my-app -w my-workspace
 ```
 
-_See code: [src/commands/app/status/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/app/status/index.ts)_
+_See code: [src/commands/app/status/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/app/status/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -349,7 +328,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya clone PROJECT`
 
@@ -374,7 +353,7 @@ EXAMPLES
   $ hereya clone myProject --chdir=./myProject
 ```
 
-_See code: [src/commands/clone/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/clone/index.ts)_
+_See code: [src/commands/clone/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/clone/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -396,7 +375,7 @@ EXAMPLES
   $ hereya config export-backend ./path/to/export.json
 ```
 
-_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/config/export-backend/index.ts)_
+_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -413,7 +392,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/config/get-backend/index.ts)_
+_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -433,7 +412,7 @@ EXAMPLES
   $ hereya config import-backend ./path/to/cloud-backend.json
 ```
 
-_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/config/import-backend/index.ts)_
+_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -455,7 +434,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/config/use-backend/index.ts)_
+_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -481,7 +460,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -489,7 +468,7 @@ Deploy a hereya project using the project deployment package
 
 ```
 USAGE
-  $ hereya deploy -w <value> [--chdir <value>] [--debug] [--local] [--token <value>]
+  $ hereya deploy -w <value> [--chdir <value>] [--debug] [--local]
 
 FLAGS
   -w, --workspace=<value>  (required) name of the workspace to deploy the packages for
@@ -499,9 +478,6 @@ FLAGS
                            environment variable.
       --debug              enable debug mode
       --local              force local execution (skip remote executor)
-      --token=<value>      Ephemeral cloud access token used for this invocation only. Held in memory; never written to
-                           the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment
-                           variable.
 
 DESCRIPTION
   Deploy a hereya project using the project deployment package
@@ -510,7 +486,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/deploy/index.ts)_
 
 ## `hereya devenv config`
 
@@ -530,7 +506,7 @@ EXAMPLES
   $ hereya devenv config -w my-workspace
 ```
 
-_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/devenv/config/index.ts)_
+_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/devenv/config/index.ts)_
 
 ## `hereya devenv install`
 
@@ -555,7 +531,7 @@ EXAMPLES
   $ hereya devenv install -w my-workspace -p instanceType=t3.large
 ```
 
-_See code: [src/commands/devenv/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/devenv/install/index.ts)_
+_See code: [src/commands/devenv/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/devenv/install/index.ts)_
 
 ## `hereya devenv project init PROJECT`
 
@@ -587,7 +563,7 @@ EXAMPLES
   $ hereya devenv project init my-app -w my-workspace -t acme/node-starter -p region=us-east-1
 ```
 
-_See code: [src/commands/devenv/project/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/devenv/project/init/index.ts)_
+_See code: [src/commands/devenv/project/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/devenv/project/init/index.ts)_
 
 ## `hereya devenv project uninit PROJECT`
 
@@ -613,7 +589,7 @@ EXAMPLES
   $ hereya devenv project uninit my-app -w my-workspace --force
 ```
 
-_See code: [src/commands/devenv/project/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/devenv/project/uninit/index.ts)_
+_See code: [src/commands/devenv/project/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/devenv/project/uninit/index.ts)_
 
 ## `hereya devenv ssh`
 
@@ -633,7 +609,7 @@ EXAMPLES
   $ hereya devenv ssh -w my-workspace
 ```
 
-_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/devenv/ssh/index.ts)_
+_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/devenv/ssh/index.ts)_
 
 ## `hereya devenv uninstall`
 
@@ -654,7 +630,7 @@ EXAMPLES
   $ hereya devenv uninstall -w my-workspace
 ```
 
-_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/devenv/uninstall/index.ts)_
+_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/devenv/uninstall/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -687,7 +663,7 @@ EXAMPLES
   $ hereya doc my-package --no-doc
 ```
 
-_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/doc/index.ts)_
 
 ## `hereya docker run IMAGE`
 
@@ -718,7 +694,7 @@ EXAMPLES
   $ hereya docker run myapp:latest -- --rm -v ./data:/data
 ```
 
-_See code: [src/commands/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/docker/run/index.ts)_
+_See code: [src/commands/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/docker/run/index.ts)_
 
 ## `hereya down`
 
@@ -745,7 +721,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -776,7 +752,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -803,7 +779,7 @@ EXAMPLES
   $ hereya env set FOO -v bar -w dev
 ```
 
-_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/env/set/index.ts)_
 
 ## `hereya executor start`
 
@@ -836,7 +812,7 @@ EXAMPLES
   HEREYA_TOKEN=<token> HEREYA_CLOUD_URL=https://my-cloud.example.com hereya executor start -w my-workspace
 ```
 
-_See code: [src/commands/executor/start/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/executor/start/index.ts)_
+_See code: [src/commands/executor/start/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/executor/start/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -874,7 +850,7 @@ EXAMPLES
   $ hereya flow add cloudy/docker_postgres -p DB_NAME=mydb -p DB_USER=admin
 ```
 
-_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow docker run IMAGE`
 
@@ -904,7 +880,7 @@ EXAMPLES
   $ hereya flow docker run --pin myapp:latest -- --rm
 ```
 
-_See code: [src/commands/flow/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/flow/docker/run/index.ts)_
+_See code: [src/commands/flow/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/flow/docker/run/index.ts)_
 
 ## `hereya flow down`
 
@@ -938,7 +914,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -972,7 +948,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow provid PACKAGE`
 
@@ -1001,7 +977,7 @@ EXAMPLES
   $ hereya flow provid hereya/postgres --pin
 ```
 
-_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/flow/provid/index.ts)_
+_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/flow/provid/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -1031,7 +1007,7 @@ EXAMPLES
   $ hereya flow remove cloudy/docker_postgres --profile staging
 ```
 
-_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -1060,7 +1036,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -1094,39 +1070,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/flow/up/index.ts)_
-
-## `hereya git`
-
-Run an arbitrary git command with the hereya credential helper available. Wraps `git <args...>`, propagating an ephemeral `--token` to the credential-helper grandchild via `HEREYA_EPHEMERAL_TOKEN`. After a successful `clone`, also wires the cloned repo to use the hereya credential helper for future `push`/`pull`/`fetch` operations. Use `--` to separate hereya flags from git flags so e.g. `--depth` reaches git instead of being parsed by oclif.
-
-```
-USAGE
-  $ hereya git [--chdir <value>] [--token <value>]
-
-FLAGS
-  --chdir=<value>  directory to run git in (cwd of the spawned git process)
-  --token=<value>  Ephemeral cloud access token used for this invocation only. Held in memory; never written to the
-                   keychain or `~/.hereya/secrets/`. Propagated to the git credential-helper grandchild via the
-                   HEREYA_EPHEMERAL_TOKEN env var. Takes precedence over the HEREYA_TOKEN environment variable.
-
-DESCRIPTION
-  Run an arbitrary git command with the hereya credential helper available. Wraps `git <args...>`, propagating an
-  ephemeral `--token` to the credential-helper grandchild via `HEREYA_EPHEMERAL_TOKEN`. After a successful `clone`, also
-  wires the cloned repo to use the hereya credential helper for future `push`/`pull`/`fetch` operations. Use `--` to
-  separate hereya flags from git flags so e.g. `--depth` reaches git instead of being parsed by oclif.
-
-EXAMPLES
-  $ hereya git --token <token> -- push
-
-  $ hereya git --token <token> -- pull --rebase
-
-  $ hereya git --token <token> -- clone https://github.com/owner/repo my-dir
-
-  $ hereya git -- log --oneline -10
-```
-
-_See code: [src/commands/git/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/git/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -1183,7 +1127,37 @@ EXAMPLES
   $ hereya import org/my-package -f state.tfstate -w my-workspace
 ```
 
-_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/import/index.ts)_
+
+## `hereya import-repo PROJECT`
+
+Register an existing GitHub repository as a hereya project so it can be deployed via the remote executor.
+
+```
+USAGE
+  $ hereya import-repo PROJECT -r <value> -w <value> [--chdir <value>] [--clone]
+
+ARGUMENTS
+  PROJECT  project name
+
+FLAGS
+  -r, --repo-url=<value>   (required) GitHub HTTPS clone URL (e.g. https://github.com/owner/repo.git)
+  -w, --workspace=<value>  (required) workspace to set as default
+      --chdir=<value>      directory to clone into (only meaningful with --clone)
+      --clone              also clone the repository locally and write hereya.yaml after the import
+
+DESCRIPTION
+  Register an existing GitHub repository as a hereya project so it can be deployed via the remote executor.
+
+EXAMPLES
+  $ hereya import-repo myProject -w=dev -r=https://github.com/acme/api.git
+
+  $ hereya import-repo myProject -w=dev -r=https://github.com/acme/api --clone
+
+  $ hereya import-repo myProject -w=dev -r=https://github.com/acme/api --clone --chdir=./api
+```
+
+_See code: [src/commands/import-repo/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/import-repo/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -1191,8 +1165,7 @@ Initialize hereya in a project directory.
 
 ```
 USAGE
-  $ hereya init PROJECT -w <value> [--chdir <value>] [-d <value>] [-p <value>...] [-t <value>] [--token
-    <value>]
+  $ hereya init PROJECT -w <value> [--chdir <value>] [-d <value>] [-p <value>...] [-t <value>]
 
 ARGUMENTS
   PROJECT  project name
@@ -1204,9 +1177,6 @@ FLAGS
   -t, --template=<value>          template package name (e.g. owner/repo)
   -w, --workspace=<value>         (required) workspace to set as default
       --chdir=<value>             directory to run command in
-      --token=<value>             Ephemeral cloud access token used for this invocation only. Held in memory; never
-                                  written to the keychain or `~/.hereya/secrets/`. Takes precedence over the
-                                  HEREYA_TOKEN environment variable.
 
 DESCRIPTION
   Initialize hereya in a project directory.
@@ -1221,7 +1191,7 @@ EXAMPLES
   $ hereya init myProject -w=dev -t=acme/node-starter -d=prod -p region=us-east-1
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/init/index.ts)_
 
 ## `hereya list`
 
@@ -1238,7 +1208,7 @@ EXAMPLES
   $ hereya list
 ```
 
-_See code: [src/commands/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/list/index.ts)_
+_See code: [src/commands/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/list/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -1267,7 +1237,7 @@ EXAMPLES
   $ hereya login --token=your-token https://cloud.hereya.dev
 ```
 
-_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -1284,7 +1254,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/logout/index.ts)_
 
 ## `hereya provid PACKAGE`
 
@@ -1312,7 +1282,7 @@ EXAMPLES
   $ hereya provid hereya/postgres --workspace staging
 ```
 
-_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/provid/index.ts)_
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -1320,13 +1290,11 @@ Publish a package to the Hereya registry
 
 ```
 USAGE
-  $ hereya publish [--chdir <value>] [--token <value>]
+  $ hereya publish [--chdir <value>]
 
 FLAGS
   --chdir=<value>  Directory where the command will be executed.
                    If not specified, it defaults to the current working directory.
-  --token=<value>  Ephemeral cloud access token used for this invocation only. Held in memory; never written to the
-                   keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.
 
 DESCRIPTION
   Publish a package to the Hereya registry
@@ -1337,7 +1305,7 @@ EXAMPLES
   $ hereya publish --chdir=/path/to/package
 ```
 
-_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -1365,7 +1333,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -1373,7 +1341,7 @@ Run a command with hereya env vars.
 
 ```
 USAGE
-  $ hereya run CMD... [--chdir <value>] [--token <value>] [-w <value>]
+  $ hereya run CMD... [--chdir <value>] [-w <value>]
 
 ARGUMENTS
   CMD...  command to run
@@ -1381,9 +1349,6 @@ ARGUMENTS
 FLAGS
   -w, --workspace=<value>  name of the workspace to run the command in
       --chdir=<value>      directory to run command in
-      --token=<value>      Ephemeral cloud access token used for this invocation only. Held in memory; never written to
-                           the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment
-                           variable.
 
 DESCRIPTION
   Run a command with hereya env vars.
@@ -1394,7 +1359,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -1402,7 +1367,7 @@ Search for packages in the registry
 
 ```
 USAGE
-  $ hereya search QUERY [-C <value>] [-j] [-l <value>] [--token <value>]
+  $ hereya search QUERY [-C <value>] [-j] [-l <value>]
 
 ARGUMENTS
   QUERY  Search query string
@@ -1410,8 +1375,6 @@ ARGUMENTS
 FLAGS
   -j, --json           Output in JSON format
   -l, --limit=<value>  [default: 20] Maximum number of results to return
-      --token=<value>  Ephemeral cloud access token used for this invocation only. Held in memory; never written to the
-                       keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.
 
 GLOBAL FLAGS
   -C, --chdir=<value>  [default: .] directory to run command in
@@ -1427,7 +1390,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -1452,7 +1415,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -1460,7 +1423,7 @@ Undeploy a hereya project by removing all resources.
 
 ```
 USAGE
-  $ hereya undeploy -w <value> [--chdir <value>] [--debug] [--local] [--token <value>]
+  $ hereya undeploy -w <value> [--chdir <value>] [--debug] [--local]
 
 FLAGS
   -w, --workspace=<value>  (required) name of the workspace to undeploy the packages for
@@ -1470,9 +1433,6 @@ FLAGS
                            environment variable.
       --debug              enable debug mode
       --local              force local execution (skip remote executor)
-      --token=<value>      Ephemeral cloud access token used for this invocation only. Held in memory; never written to
-                           the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment
-                           variable.
 
 DESCRIPTION
   Undeploy a hereya project by removing all resources.
@@ -1481,7 +1441,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/undeploy/index.ts)_
 
 ## `hereya uninit PROJECT`
 
@@ -1509,7 +1469,7 @@ EXAMPLES
   $ hereya uninit myProject -w dev -p prodWorkspace=prod
 ```
 
-_See code: [src/commands/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/uninit/index.ts)_
+_See code: [src/commands/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/uninit/index.ts)_
 
 ## `hereya up`
 
@@ -1517,7 +1477,7 @@ Provision all packages in the project.
 
 ```
 USAGE
-  $ hereya up [--chdir <value>] [--debug] [--deploy] [-s <value>...] [--token <value>] [-w <value>]
+  $ hereya up [--chdir <value>] [--debug] [--deploy] [-s <value>...] [-w <value>]
 
 FLAGS
   -s, --select=<value>...  [default: ] select the packages to provision
@@ -1528,9 +1488,6 @@ FLAGS
                            environment variable.
       --debug              enable debug mode
       --deploy             provision deployment companion packages
-      --token=<value>      Ephemeral cloud access token used for this invocation only. Held in memory; never written to
-                           the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment
-                           variable.
 
 DESCRIPTION
   Provision all packages in the project.
@@ -1539,7 +1496,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/up/index.ts)_
 
 ## `hereya update [VERSION]`
 
@@ -1561,7 +1518,7 @@ EXAMPLES
   $ hereya update 0.75.0
 ```
 
-_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/update/index.ts)_
+_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/update/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -1586,7 +1543,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -1606,7 +1563,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -1632,7 +1589,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -1656,7 +1613,7 @@ EXAMPLES
   $ hereya workspace env set -w my-workspace -n myVar -v my-value -i aws -s
 ```
 
-_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/env/set/index.ts)_
+_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1677,7 +1634,7 @@ EXAMPLES
   $ hereya workspace env unset -w my-workspace -n myVar
 ```
 
-_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/env/unset/index.ts)_
+_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace executor install`
 
@@ -1685,21 +1642,18 @@ Install a remote executor into a workspace
 
 ```
 USAGE
-  $ hereya workspace executor install -w <value> [--debug] [-f] [--token <value>]
+  $ hereya workspace executor install -w <value> [--debug] [-f]
 
 FLAGS
   -f, --force              force reinstall even if executor is already installed
   -w, --workspace=<value>  (required) name of the workspace
       --debug              enable debug mode
-      --token=<value>      Ephemeral cloud access token used for this invocation only. Held in memory; never written to
-                           the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment
-                           variable.
 
 DESCRIPTION
   Install a remote executor into a workspace
 ```
 
-_See code: [src/commands/workspace/executor/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/executor/install/index.ts)_
+_See code: [src/commands/workspace/executor/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/executor/install/index.ts)_
 
 ## `hereya workspace executor token`
 
@@ -1707,19 +1661,16 @@ Generate a workspace-scoped executor token for the remote executor
 
 ```
 USAGE
-  $ hereya workspace executor token -w <value> [--token <value>]
+  $ hereya workspace executor token -w <value>
 
 FLAGS
   -w, --workspace=<value>  (required) name of the workspace
-      --token=<value>      Ephemeral cloud access token used for this invocation only. Held in memory; never written to
-                           the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment
-                           variable.
 
 DESCRIPTION
   Generate a workspace-scoped executor token for the remote executor
 ```
 
-_See code: [src/commands/workspace/executor/token/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/executor/token/index.ts)_
+_See code: [src/commands/workspace/executor/token/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/executor/token/index.ts)_
 
 ## `hereya workspace executor uninstall`
 
@@ -1727,20 +1678,17 @@ Uninstall the remote executor from a workspace
 
 ```
 USAGE
-  $ hereya workspace executor uninstall -w <value> [--debug] [--token <value>]
+  $ hereya workspace executor uninstall -w <value> [--debug]
 
 FLAGS
   -w, --workspace=<value>  (required) name of the workspace
       --debug              enable debug mode
-      --token=<value>      Ephemeral cloud access token used for this invocation only. Held in memory; never written to
-                           the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment
-                           variable.
 
 DESCRIPTION
   Uninstall the remote executor from a workspace
 ```
 
-_See code: [src/commands/workspace/executor/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/executor/uninstall/index.ts)_
+_See code: [src/commands/workspace/executor/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/executor/uninstall/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1767,7 +1715,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1791,7 +1739,7 @@ EXAMPLES
   $ hereya workspace list --org personal
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1815,7 +1763,7 @@ EXAMPLES
   $ hereya workspace set-profile prod-profile -w production
 ```
 
-_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/set-profile/index.ts)_
+_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1842,5 +1790,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.87.0/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->