hereya-cli 0.88.0 → 0.89.1

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.88.0 linux-x64 node-v24.14.1
+hereya-cli/0.89.1 linux-x64 node-v24.14.1
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -68,6 +68,7 @@ USAGE
 * [`hereya flow up`](#hereya-flow-up)
 * [`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)
@@ -127,7 +128,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/add/index.ts)_
 
 ## `hereya app deploy NAME`
 
@@ -161,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.88.0/src/commands/app/deploy/index.ts)_
+_See code: [src/commands/app/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/app/deploy/index.ts)_
 
 ## `hereya app deployments NAME`
 
@@ -181,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.88.0/src/commands/app/deployments/index.ts)_
+_See code: [src/commands/app/deployments/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/app/deployments/index.ts)_
 
 ## `hereya app destroy NAME`
 
@@ -210,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.88.0/src/commands/app/destroy/index.ts)_
+_See code: [src/commands/app/destroy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/app/destroy/index.ts)_
 
 ## `hereya app env NAME [KEY]`
 
@@ -236,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.88.0/src/commands/app/env/index.ts)_
+_See code: [src/commands/app/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/app/env/index.ts)_
 
 ## `hereya app list`
 
@@ -253,7 +254,7 @@ EXAMPLES
   $ hereya app list
 ```
 
-_See code: [src/commands/app/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/app/list/index.ts)_
+_See code: [src/commands/app/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/app/list/index.ts)_
 
 ## `hereya app new DIRNAME`
 
@@ -279,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.88.0/src/commands/app/new/index.ts)_
+_See code: [src/commands/app/new/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/app/new/index.ts)_
 
 ## `hereya app status NAME`
 
@@ -302,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.88.0/src/commands/app/status/index.ts)_
+_See code: [src/commands/app/status/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/app/status/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -327,7 +328,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/bootstrap/index.ts)_
 
 ## `hereya clone PROJECT`
 
@@ -352,7 +353,7 @@ EXAMPLES
   $ hereya clone myProject --chdir=./myProject
 ```
 
-_See code: [src/commands/clone/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/clone/index.ts)_
+_See code: [src/commands/clone/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/clone/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -374,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.88.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.1/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -391,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.88.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.1/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -411,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.88.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.1/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -433,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.88.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.1/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -459,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.88.0/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -485,7 +486,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/deploy/index.ts)_
 
 ## `hereya devenv config`
 
@@ -505,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.88.0/src/commands/devenv/config/index.ts)_
+_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/devenv/config/index.ts)_
 
 ## `hereya devenv install`
 
@@ -530,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.88.0/src/commands/devenv/install/index.ts)_
+_See code: [src/commands/devenv/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/devenv/install/index.ts)_
 
 ## `hereya devenv project init PROJECT`
 
@@ -562,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.88.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.1/src/commands/devenv/project/init/index.ts)_
 
 ## `hereya devenv project uninit PROJECT`
 
@@ -588,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.88.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.1/src/commands/devenv/project/uninit/index.ts)_
 
 ## `hereya devenv ssh`
 
@@ -608,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.88.0/src/commands/devenv/ssh/index.ts)_
+_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/devenv/ssh/index.ts)_
 
 ## `hereya devenv uninstall`
 
@@ -629,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.88.0/src/commands/devenv/uninstall/index.ts)_
+_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/devenv/uninstall/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -662,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.88.0/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/doc/index.ts)_
 
 ## `hereya docker run IMAGE`
 
@@ -693,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.88.0/src/commands/docker/run/index.ts)_
+_See code: [src/commands/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/docker/run/index.ts)_
 
 ## `hereya down`
 
@@ -720,7 +721,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -751,7 +752,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -778,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.88.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/env/set/index.ts)_
 
 ## `hereya executor start`
 
@@ -811,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.88.0/src/commands/executor/start/index.ts)_
+_See code: [src/commands/executor/start/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/executor/start/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -849,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.88.0/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/flow/add/index.ts)_
 
 ## `hereya flow docker run IMAGE`
 
@@ -879,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.88.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.1/src/commands/flow/docker/run/index.ts)_
 
 ## `hereya flow down`
 
@@ -913,7 +914,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -947,7 +948,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/flow/env/index.ts)_
 
 ## `hereya flow provid PACKAGE`
 
@@ -976,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.88.0/src/commands/flow/provid/index.ts)_
+_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/flow/provid/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -1006,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.88.0/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -1035,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.88.0/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -1069,7 +1070,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -1126,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.88.0/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/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.1/src/commands/import-repo/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -1160,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.88.0/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/init/index.ts)_
 
 ## `hereya list`
 
@@ -1177,7 +1208,7 @@ EXAMPLES
   $ hereya list
 ```
 
-_See code: [src/commands/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/list/index.ts)_
+_See code: [src/commands/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/list/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -1206,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.88.0/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -1223,7 +1254,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/logout/index.ts)_
 
 ## `hereya provid PACKAGE`
 
@@ -1251,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.88.0/src/commands/provid/index.ts)_
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -1274,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.88.0/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -1302,7 +1333,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -1328,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.88.0/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -1359,7 +1390,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -1384,7 +1415,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -1410,7 +1441,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/undeploy/index.ts)_
 
 ## `hereya uninit PROJECT`
 
@@ -1438,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.88.0/src/commands/uninit/index.ts)_
+_See code: [src/commands/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/uninit/index.ts)_
 
 ## `hereya up`
 
@@ -1465,7 +1496,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/up/index.ts)_
 
 ## `hereya update [VERSION]`
 
@@ -1487,7 +1518,7 @@ EXAMPLES
   $ hereya update 0.75.0
 ```
 
-_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/update/index.ts)_
+_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/update/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -1512,7 +1543,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -1532,7 +1563,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.88.0/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -1558,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.88.0/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -1582,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.88.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.1/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1603,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.88.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.1/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace executor install`
 
@@ -1622,7 +1653,7 @@ 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.88.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.1/src/commands/workspace/executor/install/index.ts)_
 
 ## `hereya workspace executor token`
 
@@ -1639,7 +1670,7 @@ 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.88.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.1/src/commands/workspace/executor/token/index.ts)_
 
 ## `hereya workspace executor uninstall`
 
@@ -1657,7 +1688,7 @@ 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.88.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.1/src/commands/workspace/executor/uninstall/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1684,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.88.0/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1708,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.88.0/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1732,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.88.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.1/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1759,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.88.0/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.89.1/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

package/dist/backend/cloud/cloud-backend.d.ts

@@ -1,6 +1,6 @@
 import { Config } from '../../lib/config/common.js';
 import { IParameterSpec } from '../../lib/package/index.js';
-import { AddPackageToWorkspaceInput, AddPackageToWorkspaceOutput, Backend, CreateWorkspaceInput, CreateWorkspaceOutput, DeleteStateInput, DeleteStateOutput, DeleteWorkspaceInput, DeleteWorkspaceOutput, ExportBackendOutput, GetPackageOutput, GetProjectMetadataInput, GetProjectMetadataOutput, GetProvisioningIdInput, GetProvisioningIdOutput, GetStateInput, GetStateOutput, GetWorkspaceEnvInput, GetWorkspaceEnvOutput, GetWorkspaceOutput, ImportBackendInput, ImportBackendOutput, InitProjectInput, InitProjectOutput, ListPackageVersionsOutput, ListProjectsOutput, ListWorkspacesInput, PublishPackageInput, PublishPackageOutput, RemovePackageFromWorkspaceInput, RemovePackageFromWorkspaceOutput, SaveProjectMetadataInput, SaveProjectMetadataOutput, SearchPackagesInput, SearchPackagesOutput, SetEnvVarInput, SetEnvVarOutput, UnsetEnvVarInput, UnsetEnvVarOutput, UpdateWorkspaceInput, UpdateWorkspaceOutput } from '../common.js';
+import { AddPackageToWorkspaceInput, AddPackageToWorkspaceOutput, Backend, CreateWorkspaceInput, CreateWorkspaceOutput, DeleteStateInput, DeleteStateOutput, DeleteWorkspaceInput, DeleteWorkspaceOutput, ExportBackendOutput, GetPackageOutput, GetProjectMetadataInput, GetProjectMetadataOutput, GetProvisioningIdInput, GetProvisioningIdOutput, GetStateInput, GetStateOutput, GetWorkspaceEnvInput, GetWorkspaceEnvOutput, GetWorkspaceOutput, ImportBackendInput, ImportBackendOutput, ImportProjectInput, ImportProjectOutput, InitProjectInput, InitProjectOutput, ListPackageVersionsOutput, ListProjectsOutput, ListWorkspacesInput, PublishPackageInput, PublishPackageOutput, RemovePackageFromWorkspaceInput, RemovePackageFromWorkspaceOutput, SaveProjectMetadataInput, SaveProjectMetadataOutput, SearchPackagesInput, SearchPackagesOutput, SetEnvVarInput, SetEnvVarOutput, UnsetEnvVarInput, UnsetEnvVarOutput, UpdateWorkspaceInput, UpdateWorkspaceOutput } from '../common.js';
 interface CloudBackendConfig {
     accessToken: string;
     clientId: string;
@@ -158,6 +158,7 @@ export declare class CloudBackend implements Backend {
     getWorkspace(name: string): Promise<GetWorkspaceOutput>;
     getWorkspaceEnv(input: GetWorkspaceEnvInput): Promise<GetWorkspaceEnvOutput>;
     importBackend(input: ImportBackendInput): Promise<ImportBackendOutput>;
+    importProject(input: ImportProjectInput): Promise<ImportProjectOutput>;
     init(input: InitProjectInput): Promise<InitProjectOutput>;
     listAppDeployments(name: string): Promise<{
         deployments: AppDeploymentSummary[];

package/dist/backend/cloud/cloud-backend.js

@@ -488,6 +488,42 @@ export class CloudBackend {
             success: true,
         };
     }
+    async importProject(input) {
+        const response = await fetch(`${this.config.url}/api/projects/${encodeURIComponent(input.project)}/import`, {
+            body: JSON.stringify({ repoUrl: input.repoUrl, workspace: input.workspace }),
+            headers: {
+                'Authorization': `Bearer ${this.config.accessToken}`,
+                'Content-Type': 'application/json',
+            },
+            method: 'POST',
+        });
+        const result = await this.safeResponseJson(response);
+        if (!response.ok) {
+            const reason = typeof result?.error === 'string'
+                ? result.error
+                : (result?.errors && typeof result.errors === 'object'
+                    ? JSON.stringify(result.errors)
+                    : JSON.stringify(result));
+            return {
+                ...(typeof result?.code === 'string' ? { code: result.code } : {}),
+                reason,
+                success: false,
+            };
+        }
+        if (!result?.success || !result?.project) {
+            return {
+                reason: typeof result?.error === 'string' ? result.error : 'Unexpected response from server',
+                success: false,
+            };
+        }
+        return {
+            project: {
+                defaultWorkspace: result.project.defaultWorkspace,
+                name: result.project.name,
+            },
+            success: true,
+        };
+    }
     async init(input) {
         const formData = new FormData();
         formData.append('name', input.project);

package/dist/backend/common.d.ts

@@ -15,6 +15,7 @@ export interface Backend {
     getWorkspace(workspace: string): Promise<GetWorkspaceOutput>;
     getWorkspaceEnv(input: GetWorkspaceEnvInput): Promise<GetWorkspaceEnvOutput>;
     importBackend(input: ImportBackendInput): Promise<ImportBackendOutput>;
+    importProject?(input: ImportProjectInput): Promise<ImportProjectOutput>;
     init(options: InitProjectInput): Promise<InitProjectOutput>;
     listPackageVersions?(name: string): Promise<ListPackageVersionsOutput>;
     listProjects?(): Promise<ListProjectsOutput>;
@@ -363,6 +364,22 @@ export type SaveProjectMetadataOutput = {
 } | {
     success: true;
 };
+export interface ImportProjectInput {
+    project: string;
+    repoUrl: string;
+    workspace: string;
+}
+export type ImportProjectOutput = {
+    code?: string;
+    reason: string;
+    success: false;
+} | {
+    project: {
+        defaultWorkspace: string;
+        name: string;
+    };
+    success: true;
+};
 export type ProjectSummary = {
     defaultWorkspace: string;
     name: string;

package/dist/commands/clone/index.js

@@ -36,7 +36,7 @@ export default class Clone extends Command {
                     }
                     const metadata$ = await backend.getProjectMetadata({ project: args.project });
                     if (!metadata$.found) {
-                        throw new Error(`Project metadata not found for ${args.project}. Was it initialized with a template?`);
+                        throw new Error(`Project metadata not found for ${args.project}. Was it initialized or imported?`);
                     }
                     ctx.metadata = metadata$.metadata;
                     ctx.defaultWorkspace = metadata$.defaultWorkspace;
@@ -59,7 +59,7 @@ export default class Clone extends Command {
                         workspace: ctx.defaultWorkspace,
                     });
                     if (!ctx.resolvedGitEnv.hereyaGitRemoteUrl) {
-                        throw new Error('Project metadata does not contain hereyaGitRemoteUrl. Was it initialized with a template?');
+                        throw new Error(`Project metadata does not contain hereyaGitRemoteUrl for ${args.project}. Was it initialized or imported?`);
                     }
                 },
                 title: 'Resolving git credentials',

package/dist/commands/import-repo/index.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class ImportRepo extends Command {
+    static args: {
+        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        chdir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        clone: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'repo-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/import-repo/index.js

@@ -0,0 +1,111 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { Listr, ListrLogger, ListrLogLevels } from 'listr2';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getBackend } from '../../backend/index.js';
+import { cloneAndConfigureProjectTasks } from '../../lib/clone-and-configure.js';
+import { getLogPath } from '../../lib/log.js';
+export default class ImportRepo extends Command {
+    static args = {
+        project: Args.string({ description: 'project name', required: true }),
+    };
+    static description = 'Register an existing GitHub repository as a hereya project so it can be deployed via the remote executor.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> myProject -w=dev -r=https://github.com/acme/api.git',
+        '<%= config.bin %> <%= command.id %> myProject -w=dev -r=https://github.com/acme/api --clone',
+        '<%= config.bin %> <%= command.id %> myProject -w=dev -r=https://github.com/acme/api --clone --chdir=./api',
+    ];
+    static flags = {
+        chdir: Flags.string({
+            description: 'directory to clone into (only meaningful with --clone)',
+            required: false,
+        }),
+        clone: Flags.boolean({
+            default: false,
+            description: 'also clone the repository locally and write hereya.yaml after the import',
+        }),
+        'repo-url': Flags.string({
+            char: 'r',
+            description: 'GitHub HTTPS clone URL (e.g. https://github.com/owner/repo.git)',
+            required: true,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'workspace to set as default',
+            required: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ImportRepo);
+        const targetDir = flags.chdir
+            || path.join(process.cwd(), args.project.replaceAll('/', '-'));
+        if (flags.clone && fs.existsSync(targetDir)) {
+            this.error(`Directory ${targetDir} already exists.`);
+        }
+        const backend = await getBackend();
+        if (!backend.importProject) {
+            this.error('hereya import-repo requires the cloud backend. Run `hereya login` first.');
+        }
+        if (!flags.clone) {
+            const importOutput = await backend.importProject({
+                project: args.project,
+                repoUrl: flags['repo-url'],
+                workspace: flags.workspace,
+            });
+            if (!importOutput.success) {
+                const codeSuffix = importOutput.code ? ` [${importOutput.code}]` : '';
+                this.error(`${importOutput.reason}${codeSuffix}`);
+            }
+            this.log(`Project ${args.project} imported.`);
+            this.log(`Run 'hereya clone ${args.project}' to fetch the source locally, then 'hereya deploy -w <deploy-workspace>' to deploy.`);
+            return;
+        }
+        const task = new Listr([
+            {
+                async task(ctx) {
+                    const importResult = await backend.importProject({
+                        project: args.project,
+                        repoUrl: flags['repo-url'],
+                        workspace: flags.workspace,
+                    });
+                    if (!importResult.success) {
+                        const codeSuffix = importResult.code ? ` [${importResult.code}]` : '';
+                        throw new Error(`${importResult.reason}${codeSuffix}`);
+                    }
+                    ctx.importOutput = importResult;
+                },
+                title: 'Importing project',
+            },
+            {
+                async task(ctx) {
+                    if (!backend.getProjectMetadata) {
+                        throw new Error('hereya import-repo --clone requires the cloud backend. Run `hereya login` first.');
+                    }
+                    const metadata$ = await backend.getProjectMetadata({ project: args.project });
+                    if (!metadata$.found) {
+                        throw new Error(`Project metadata not found for ${args.project} after import.`);
+                    }
+                    ctx.metadata = metadata$.metadata;
+                },
+                title: 'Fetching project metadata',
+            },
+            ...cloneAndConfigureProjectTasks({
+                getEnv: (ctx) => ctx.metadata.env || {},
+                getProject: () => args.project,
+                getWorkspace: () => flags.workspace,
+                hereyaBinPath: process.argv[1],
+                missingRemoteUrlError: `Project metadata does not contain hereyaGitRemoteUrl for ${args.project}. Did the import populate the workspace github-app config?`,
+                targetDir,
+            }),
+        ], { concurrent: false });
+        try {
+            await task.run();
+            const myLogger = new ListrLogger({ useIcons: false });
+            myLogger.log(ListrLogLevels.COMPLETED, `Project ${args.project} imported and cloned successfully`);
+            myLogger.log(ListrLogLevels.COMPLETED, `Project directory: ${targetDir}`);
+        }
+        catch (error) {
+            this.error(`${error.message}\n\nSee ${getLogPath()} for more details`);
+        }
+    }
+}

package/dist/commands/init/index.js

@@ -4,8 +4,8 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { getBackend } from '../../backend/index.js';
 import { getExecutorForWorkspace } from '../../executor/context.js';
+import { cloneAndConfigureProjectTasks } from '../../lib/clone-and-configure.js';
 import { getConfigManager } from '../../lib/config/index.js';
-import { gitUtils } from '../../lib/git-utils.js';
 import { hereyaTokenUtils } from '../../lib/hereya-token.js';
 import { getLogger, getLogPath } from '../../lib/log.js';
 import { arrayOfStringToObject } from '../../lib/object-utils.js';
@@ -115,57 +115,14 @@ export default class Init extends Command {
                     },
                     title: 'Saving template metadata',
                 },
-                {
-                    async task(ctx) {
-                        const gitEnvToResolve = {};
-                        for (const [key, value] of Object.entries(ctx.prefixedEnv)) {
-                            if (key.startsWith('hereyaGit'))
-                                gitEnvToResolve[key] = value;
-                        }
-                        const executor$ = await getExecutorForWorkspace(flags.workspace);
-                        if (!executor$.success)
-                            throw new Error(executor$.reason);
-                        ctx.resolvedGitEnv = await executor$.executor.resolveEnvValues({
-                            env: gitEnvToResolve,
-                            project: args.project,
-                            workspace: flags.workspace,
-                        });
-                        if (!ctx.resolvedGitEnv.hereyaGitRemoteUrl) {
-                            throw new Error('Template did not provide hereyaGitRemoteUrl. Templates must export hereyaGitRemoteUrl.');
-                        }
-                    },
-                    title: 'Resolving git credentials',
-                },
-                {
-                    async task(ctx) {
-                        const cloneResult = await gitUtils.cloneWithCredentialHelper({
-                            gitUrl: ctx.resolvedGitEnv.hereyaGitRemoteUrl,
-                            hereyaBinPath: process.argv[1],
-                            password: ctx.resolvedGitEnv.hereyaGitPassword,
-                            targetDir,
-                            username: ctx.resolvedGitEnv.hereyaGitUsername,
-                        });
-                        if (!cloneResult.success)
-                            throw new Error(cloneResult.reason);
-                    },
-                    title: 'Cloning project repository',
-                },
-                {
-                    async task(ctx) {
-                        const configManager = getConfigManager();
-                        const existing = await configManager.loadConfig({ projectRootDir: targetDir });
-                        const config = {
-                            ...(existing.found ? existing.config : {}),
-                            project: ctx.initOutput.project.name,
-                            workspace: ctx.initOutput.workspace.name,
-                        };
-                        await configManager.saveConfig({ config, projectRootDir: targetDir });
-                        await gitUtils.setupCredentialHelper({ hereyaBinPath: process.argv[1], projectDir: targetDir });
-                        const backend = await getBackend();
-                        await backend.saveState(config, flags.workspace);
-                    },
-                    title: 'Setting up project',
-                },
+                ...cloneAndConfigureProjectTasks({
+                    getEnv: (ctx) => ctx.prefixedEnv,
+                    getProject: (ctx) => ctx.initOutput.project.name,
+                    getWorkspace: () => flags.workspace,
+                    hereyaBinPath: process.argv[1],
+                    missingRemoteUrlError: 'Template did not provide hereyaGitRemoteUrl. Templates must export hereyaGitRemoteUrl.',
+                    targetDir,
+                }),
             ], { concurrent: false });
             try {
                 await task.run();

package/dist/lib/clone-and-configure.d.ts

@@ -0,0 +1,43 @@
+import { ListrTask } from 'listr2';
+export interface CloneAndConfigureCtx {
+    resolvedGitEnv: Record<string, string>;
+}
+export interface CloneAndConfigureProjectInput<Ctx extends CloneAndConfigureCtx = CloneAndConfigureCtx> {
+    /**
+     * Returns the env map that should be inspected for `hereyaGit*` markers.
+     * Called when the "Resolving git credentials" task runs, so callers can
+     * read up-to-date values from the Listr context (e.g. `ctx.prefixedEnv`)
+     * after earlier tasks have populated it.
+     */
+    getEnv(ctx: Ctx): Promise<Record<string, string>> | Record<string, string>;
+    /**
+     * Project name to use for env resolution / config persistence / state save.
+     * Can be a value or a callback that reads it from ctx (useful when the
+     * canonical name comes from a previous task, e.g. `ctx.initOutput.project.name`).
+     */
+    getProject(ctx: Ctx): Promise<string> | string;
+    /**
+     * Workspace name to use for env resolution / config persistence / state save.
+     */
+    getWorkspace(ctx: Ctx): Promise<string> | string;
+    hereyaBinPath: string;
+    /**
+     * Optional override for the error thrown when `hereyaGitRemoteUrl` is missing
+     * from the resolved git env. Lets call sites surface a flow-specific message
+     * (e.g. "Template did not provide hereyaGitRemoteUrl").
+     */
+    missingRemoteUrlError?: string;
+    targetDir: string;
+}
+/**
+ * Returns Listr tasks that:
+ *  1. Filter `hereyaGit*` env vars (from a caller-supplied env map) and resolve
+ *     them via the workspace executor (this exercises the github-app marker path).
+ *  2. Clone the repository using the resolved git credentials and the hereya
+ *     credential helper.
+ *  3. Persist the local hereya.yaml, set up the credential helper for the
+ *     cloned repo, and save the project state on the cloud backend.
+ *
+ * Used by both `hereya init` (template flow) and `hereya import-repo --clone`.
+ */
+export declare function cloneAndConfigureProjectTasks<Ctx extends CloneAndConfigureCtx = CloneAndConfigureCtx>(input: CloneAndConfigureProjectInput<Ctx>): ListrTask<Ctx>[];

package/dist/lib/clone-and-configure.js

@@ -0,0 +1,77 @@
+import { getBackend } from '../backend/index.js';
+import { getExecutorForWorkspace } from '../executor/context.js';
+import { getConfigManager } from './config/index.js';
+import { gitUtils } from './git-utils.js';
+/**
+ * Returns Listr tasks that:
+ *  1. Filter `hereyaGit*` env vars (from a caller-supplied env map) and resolve
+ *     them via the workspace executor (this exercises the github-app marker path).
+ *  2. Clone the repository using the resolved git credentials and the hereya
+ *     credential helper.
+ *  3. Persist the local hereya.yaml, set up the credential helper for the
+ *     cloned repo, and save the project state on the cloud backend.
+ *
+ * Used by both `hereya init` (template flow) and `hereya import-repo --clone`.
+ */
+export function cloneAndConfigureProjectTasks(input) {
+    const { getEnv, getProject, getWorkspace, hereyaBinPath, missingRemoteUrlError, targetDir } = input;
+    return [
+        {
+            async task(ctx) {
+                const env = await getEnv(ctx);
+                const project = await getProject(ctx);
+                const workspace = await getWorkspace(ctx);
+                const gitEnvToResolve = {};
+                for (const [key, value] of Object.entries(env || {})) {
+                    if (key.startsWith('hereyaGit'))
+                        gitEnvToResolve[key] = value;
+                }
+                const executor$ = await getExecutorForWorkspace(workspace);
+                if (!executor$.success)
+                    throw new Error(executor$.reason);
+                ctx.resolvedGitEnv = await executor$.executor.resolveEnvValues({
+                    env: gitEnvToResolve,
+                    project,
+                    workspace,
+                });
+                if (!ctx.resolvedGitEnv.hereyaGitRemoteUrl) {
+                    throw new Error(missingRemoteUrlError
+                        ?? 'Project metadata does not contain hereyaGitRemoteUrl.');
+                }
+            },
+            title: 'Resolving git credentials',
+        },
+        {
+            async task(ctx) {
+                const cloneResult = await gitUtils.cloneWithCredentialHelper({
+                    gitUrl: ctx.resolvedGitEnv.hereyaGitRemoteUrl,
+                    hereyaBinPath,
+                    password: ctx.resolvedGitEnv.hereyaGitPassword,
+                    targetDir,
+                    username: ctx.resolvedGitEnv.hereyaGitUsername,
+                });
+                if (!cloneResult.success)
+                    throw new Error(cloneResult.reason);
+            },
+            title: 'Cloning project repository',
+        },
+        {
+            async task(ctx) {
+                const project = await getProject(ctx);
+                const workspace = await getWorkspace(ctx);
+                const configManager = getConfigManager();
+                const existing = await configManager.loadConfig({ projectRootDir: targetDir });
+                const config = {
+                    ...(existing.found ? existing.config : {}),
+                    project,
+                    workspace,
+                };
+                await configManager.saveConfig({ config, projectRootDir: targetDir });
+                await gitUtils.setupCredentialHelper({ hereyaBinPath, projectDir: targetDir });
+                const backend = await getBackend();
+                await backend.saveState(config, workspace);
+            },
+            title: 'Setting up project',
+        },
+    ];
+}

package/oclif.manifest.json

@@ -521,6 +521,71 @@
         "index.js"
       ]
     },
+    "import-repo": {
+      "aliases": [],
+      "args": {
+        "project": {
+          "description": "project name",
+          "name": "project",
+          "required": true
+        }
+      },
+      "description": "Register an existing GitHub repository as a hereya project so it can be deployed via the remote executor.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> myProject -w=dev -r=https://github.com/acme/api.git",
+        "<%= config.bin %> <%= command.id %> myProject -w=dev -r=https://github.com/acme/api --clone",
+        "<%= config.bin %> <%= command.id %> myProject -w=dev -r=https://github.com/acme/api --clone --chdir=./api"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "directory to clone into (only meaningful with --clone)",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "clone": {
+          "description": "also clone the repository locally and write hereya.yaml after the import",
+          "name": "clone",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "repo-url": {
+          "char": "r",
+          "description": "GitHub HTTPS clone URL (e.g. https://github.com/owner/repo.git)",
+          "name": "repo-url",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "workspace to set as default",
+          "name": "workspace",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "import-repo",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "import-repo",
+        "index.js"
+      ]
+    },
     "init": {
       "aliases": [],
       "args": {
@@ -3212,5 +3277,5 @@
       ]
     }
   },
-  "version": "0.88.0"
+  "version": "0.89.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hereya-cli",
   "description": "Infrastructure as Package",
-  "version": "0.88.0",
+  "version": "0.89.1",
   "author": "Hereya Developers",
   "bin": {
     "hereya": "./bin/run.js"