hereya-cli 0.77.5 → 0.78.0

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.77.5 linux-x64 node-v24.14.0
+hereya-cli/0.78.0 linux-x64 node-v24.14.0
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -32,6 +32,7 @@ USAGE
 <!-- commands -->
 * [`hereya add PACKAGE`](#hereya-add-package)
 * [`hereya bootstrap INFRASTRUCTURETYPE`](#hereya-bootstrap-infrastructuretype)
+* [`hereya clone PROJECT`](#hereya-clone-project)
 * [`hereya config export-backend [FILE]`](#hereya-config-export-backend-file)
 * [`hereya config get-backend`](#hereya-config-get-backend)
 * [`hereya config import-backend FILE`](#hereya-config-import-backend-file)
@@ -118,7 +119,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -143,7 +144,32 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/bootstrap/index.ts)_
+
+## `hereya clone PROJECT`
+
+Clone an existing template-based project to the local machine.
+
+```
+USAGE
+  $ hereya clone PROJECT [--chdir <value>]
+
+ARGUMENTS
+  PROJECT  project name
+
+FLAGS
+  --chdir=<value>  directory to clone into
+
+DESCRIPTION
+  Clone an existing template-based project to the local machine.
+
+EXAMPLES
+  $ hereya clone myProject
+
+  $ hereya clone myProject --chdir=./myProject
+```
+
+_See code: [src/commands/clone/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/clone/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -165,7 +191,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.77.5/src/commands/config/export-backend/index.ts)_
+_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -182,7 +208,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/config/get-backend/index.ts)_
+_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -202,7 +228,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.77.5/src/commands/config/import-backend/index.ts)_
+_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -224,7 +250,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/config/use-backend/index.ts)_
+_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -250,7 +276,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -276,7 +302,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/deploy/index.ts)_
 
 ## `hereya devenv config`
 
@@ -296,7 +322,7 @@ EXAMPLES
   $ hereya devenv config -w my-workspace
 ```
 
-_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/devenv/config/index.ts)_
+_See code: [src/commands/devenv/config/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/devenv/config/index.ts)_
 
 ## `hereya devenv install`
 
@@ -321,7 +347,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.77.5/src/commands/devenv/install/index.ts)_
+_See code: [src/commands/devenv/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/devenv/install/index.ts)_
 
 ## `hereya devenv project init PROJECT`
 
@@ -353,7 +379,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.77.5/src/commands/devenv/project/init/index.ts)_
+_See code: [src/commands/devenv/project/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/devenv/project/init/index.ts)_
 
 ## `hereya devenv project uninit PROJECT`
 
@@ -379,7 +405,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.77.5/src/commands/devenv/project/uninit/index.ts)_
+_See code: [src/commands/devenv/project/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/devenv/project/uninit/index.ts)_
 
 ## `hereya devenv ssh`
 
@@ -399,7 +425,7 @@ EXAMPLES
   $ hereya devenv ssh -w my-workspace
 ```
 
-_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/devenv/ssh/index.ts)_
+_See code: [src/commands/devenv/ssh/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/devenv/ssh/index.ts)_
 
 ## `hereya devenv uninstall`
 
@@ -420,7 +446,7 @@ EXAMPLES
   $ hereya devenv uninstall -w my-workspace
 ```
 
-_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/devenv/uninstall/index.ts)_
+_See code: [src/commands/devenv/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/devenv/uninstall/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -453,7 +479,7 @@ EXAMPLES
   $ hereya doc my-package --no-doc
 ```
 
-_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/doc/index.ts)_
 
 ## `hereya docker run IMAGE`
 
@@ -484,7 +510,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.77.5/src/commands/docker/run/index.ts)_
+_See code: [src/commands/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/docker/run/index.ts)_
 
 ## `hereya down`
 
@@ -511,7 +537,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -542,7 +568,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -569,7 +595,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.77.5/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/env/set/index.ts)_
 
 ## `hereya executor start`
 
@@ -602,7 +628,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.77.5/src/commands/executor/start/index.ts)_
+_See code: [src/commands/executor/start/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/executor/start/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -640,7 +666,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.77.5/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow docker run IMAGE`
 
@@ -670,7 +696,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.77.5/src/commands/flow/docker/run/index.ts)_
+_See code: [src/commands/flow/docker/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/flow/docker/run/index.ts)_
 
 ## `hereya flow down`
 
@@ -704,7 +730,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -738,7 +764,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow provid PACKAGE`
 
@@ -767,7 +793,7 @@ EXAMPLES
   $ hereya flow provid hereya/postgres --pin
 ```
 
-_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/flow/provid/index.ts)_
+_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/flow/provid/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -797,7 +823,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.77.5/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -826,7 +852,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -860,7 +886,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -917,7 +943,7 @@ 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.77.5/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -951,7 +977,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.77.5/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -980,7 +1006,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.77.5/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -997,7 +1023,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/logout/index.ts)_
 
 ## `hereya provid PACKAGE`
 
@@ -1025,7 +1051,7 @@ EXAMPLES
   $ hereya provid hereya/postgres --workspace staging
 ```
 
-_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/provid/index.ts)_
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -1048,7 +1074,7 @@ EXAMPLES
   $ hereya publish --chdir=/path/to/package
 ```
 
-_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -1076,7 +1102,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -1102,7 +1128,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -1133,7 +1159,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -1158,7 +1184,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -1184,7 +1210,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/undeploy/index.ts)_
 
 ## `hereya uninit PROJECT`
 
@@ -1212,7 +1238,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.77.5/src/commands/uninit/index.ts)_
+_See code: [src/commands/uninit/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/uninit/index.ts)_
 
 ## `hereya up`
 
@@ -1239,7 +1265,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/up/index.ts)_
 
 ## `hereya update [VERSION]`
 
@@ -1261,7 +1287,7 @@ EXAMPLES
   $ hereya update 0.75.0
 ```
 
-_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/update/index.ts)_
+_See code: [src/commands/update/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/update/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -1286,7 +1312,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -1306,7 +1332,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -1332,7 +1358,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -1356,7 +1382,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.77.5/src/commands/workspace/env/set/index.ts)_
+_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1377,7 +1403,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.77.5/src/commands/workspace/env/unset/index.ts)_
+_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace executor install`
 
@@ -1396,7 +1422,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.77.5/src/commands/workspace/executor/install/index.ts)_
+_See code: [src/commands/workspace/executor/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/executor/install/index.ts)_
 
 ## `hereya workspace executor token`
 
@@ -1413,7 +1439,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.77.5/src/commands/workspace/executor/token/index.ts)_
+_See code: [src/commands/workspace/executor/token/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/executor/token/index.ts)_
 
 ## `hereya workspace executor uninstall`
 
@@ -1431,7 +1457,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.77.5/src/commands/workspace/executor/uninstall/index.ts)_
+_See code: [src/commands/workspace/executor/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/executor/uninstall/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1458,7 +1484,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1482,7 +1508,7 @@ EXAMPLES
   $ hereya workspace list --org personal
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1506,7 +1532,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.77.5/src/commands/workspace/set-profile/index.ts)_
+_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1533,5 +1559,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.77.5/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.78.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

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

@@ -250,6 +250,7 @@ export class CloudBackend {
             };
         }
         return {
+            defaultWorkspace: result.defaultWorkspace,
             found: true,
             metadata: result.metadata,
         };

package/dist/backend/common.d.ts

@@ -326,11 +326,12 @@ export type ProjectMetadata = {
     template: string;
 };
 export type GetProjectMetadataOutput = {
-    found: false;
-    reason?: string;
-} | {
+    defaultWorkspace: string;
     found: true;
     metadata: ProjectMetadata;
+} | {
+    found: false;
+    reason?: string;
 };
 export type SaveProjectMetadataInput = {
     metadata: ProjectMetadata;

package/dist/commands/clone/index.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class Clone 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>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/clone/index.js

@@ -0,0 +1,105 @@
+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 { getExecutorForWorkspace } from '../../executor/context.js';
+import { getConfigManager } from '../../lib/config/index.js';
+import { gitUtils } from '../../lib/git-utils.js';
+import { getLogPath } from '../../lib/log.js';
+export default class Clone extends Command {
+    static args = {
+        project: Args.string({ description: 'project name', required: true }),
+    };
+    static description = 'Clone an existing template-based project to the local machine.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> myProject',
+        '<%= config.bin %> <%= command.id %> myProject --chdir=./myProject',
+    ];
+    static flags = {
+        chdir: Flags.string({
+            description: 'directory to clone into',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Clone);
+        const targetDir = flags.chdir || path.join(process.cwd(), args.project.replaceAll('/', '-'));
+        if (fs.existsSync(targetDir)) {
+            this.error(`Directory ${targetDir} already exists.`);
+        }
+        const task = new Listr([
+            {
+                async task(ctx) {
+                    const backend = await getBackend();
+                    if (!backend.getProjectMetadata) {
+                        throw new Error('Clone requires 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}. Was it initialized with a template?`);
+                    }
+                    ctx.metadata = metadata$.metadata;
+                    ctx.defaultWorkspace = metadata$.defaultWorkspace;
+                },
+                title: 'Fetching project metadata',
+            },
+            {
+                async task(ctx) {
+                    const gitEnvToResolve = {};
+                    for (const [key, value] of Object.entries(ctx.metadata.env || {})) {
+                        if (key.startsWith('hereyaGit'))
+                            gitEnvToResolve[key] = value;
+                    }
+                    const executor$ = await getExecutorForWorkspace(ctx.defaultWorkspace);
+                    if (!executor$.success)
+                        throw new Error(executor$.reason);
+                    ctx.resolvedGitEnv = await executor$.executor.resolveEnvValues({ env: gitEnvToResolve });
+                    if (!ctx.resolvedGitEnv.hereyaGitRemoteUrl) {
+                        throw new Error('Project metadata does not contain hereyaGitRemoteUrl. Was it initialized with a template?');
+                    }
+                },
+                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: args.project,
+                        workspace: ctx.defaultWorkspace,
+                    };
+                    await configManager.saveConfig({ config, projectRootDir: targetDir });
+                    await gitUtils.setupCredentialHelper({ hereyaBinPath: process.argv[1], projectDir: targetDir });
+                    const backend = await getBackend();
+                    await backend.saveState(config, ctx.defaultWorkspace);
+                },
+                title: 'Setting up project',
+            },
+        ], { concurrent: false });
+        try {
+            await task.run();
+            const myLogger = new ListrLogger({ useIcons: false });
+            myLogger.log(ListrLogLevels.COMPLETED, `Project ${args.project} cloned successfully`);
+            myLogger.log(ListrLogLevels.COMPLETED, `Project directory: ${targetDir}`);
+        }
+        catch (error) {
+            this.error(`${error.message}\n\nSee ${getLogPath()} for more details`);
+        }
+    }
+}

package/oclif.manifest.json

@@ -102,6 +102,46 @@
         "index.js"
       ]
     },
+    "clone": {
+      "aliases": [],
+      "args": {
+        "project": {
+          "description": "project name",
+          "name": "project",
+          "required": true
+        }
+      },
+      "description": "Clone an existing template-based project to the local machine.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> myProject",
+        "<%= config.bin %> <%= command.id %> myProject --chdir=./myProject"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "directory to clone into",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "clone",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "clone",
+        "index.js"
+      ]
+    },
     "credential-helper": {
       "aliases": [],
       "args": {
@@ -1849,32 +1889,34 @@
         "index.js"
       ]
     },
-    "flow:remove": {
+    "flow:run": {
       "aliases": [],
       "args": {
-        "package": {
-          "description": "Remove a previously added package.",
-          "name": "package",
+        "cmd": {
+          "description": "command to run",
+          "name": "cmd",
           "required": true
         }
       },
-      "description": "Remove a package from the project in a git branch-based workspace",
+      "description": "Run a command with hereya env vars in a git branch-based workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres",
-        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging"
+        "<%= config.bin %> <%= command.id %> -- npm run dev",
+        "<%= config.bin %> <%= command.id %> --profile staging -- node index.js",
+        "<%= config.bin %> <%= command.id %> --pin -- npm test"
       ],
       "flags": {
         "chdir": {
-          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
+          "description": "directory to run command in",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
+        "pin": {
+          "description": "append git commit SHA to workspace name for commit-specific isolation",
+          "name": "pin",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -1889,49 +1931,47 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:remove",
+      "id": "flow:run",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "flow",
-        "remove",
+        "run",
         "index.js"
       ]
     },
-    "flow:run": {
+    "flow:remove": {
       "aliases": [],
       "args": {
-        "cmd": {
-          "description": "command to run",
-          "name": "cmd",
+        "package": {
+          "description": "Remove a previously added package.",
+          "name": "package",
           "required": true
         }
       },
-      "description": "Run a command with hereya env vars in a git branch-based workspace",
+      "description": "Remove a package from the project in a git branch-based workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -- npm run dev",
-        "<%= config.bin %> <%= command.id %> --profile staging -- node index.js",
-        "<%= config.bin %> <%= command.id %> --pin -- npm test"
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres",
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging"
       ],
       "flags": {
         "chdir": {
-          "description": "directory to run command in",
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "pin": {
-          "description": "append git commit SHA to workspace name for commit-specific isolation",
-          "name": "pin",
-          "required": false,
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
@@ -1946,18 +1986,18 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:run",
+      "id": "flow:remove",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "flow",
-        "run",
+        "remove",
         "index.js"
       ]
     },
@@ -2817,5 +2857,5 @@
       ]
     }
   },
-  "version": "0.77.5"
+  "version": "0.78.0"
 }

package/package.json

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