hereya-cli 0.77.5 → 0.79.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.79.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)
@@ -61,6 +62,7 @@ USAGE
 * [`hereya help [COMMAND]`](#hereya-help-command)
 * [`hereya import PACKAGE`](#hereya-import-package)
 * [`hereya init PROJECT`](#hereya-init-project)
+* [`hereya list`](#hereya-list)
 * [`hereya login [URL]`](#hereya-login-url)
 * [`hereya logout`](#hereya-logout)
 * [`hereya provid PACKAGE`](#hereya-provid-package)
@@ -118,7 +120,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.79.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -143,7 +145,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.79.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.79.0/src/commands/clone/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -165,7 +192,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.79.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -182,7 +209,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.79.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -202,7 +229,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.79.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -224,7 +251,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.79.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -250,7 +277,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.79.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -276,7 +303,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.79.0/src/commands/deploy/index.ts)_
 
 ## `hereya devenv config`
 
@@ -296,7 +323,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.79.0/src/commands/devenv/config/index.ts)_
 
 ## `hereya devenv install`
 
@@ -321,7 +348,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.79.0/src/commands/devenv/install/index.ts)_
 
 ## `hereya devenv project init PROJECT`
 
@@ -353,7 +380,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.79.0/src/commands/devenv/project/init/index.ts)_
 
 ## `hereya devenv project uninit PROJECT`
 
@@ -379,7 +406,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.79.0/src/commands/devenv/project/uninit/index.ts)_
 
 ## `hereya devenv ssh`
 
@@ -399,7 +426,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.79.0/src/commands/devenv/ssh/index.ts)_
 
 ## `hereya devenv uninstall`
 
@@ -420,7 +447,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.79.0/src/commands/devenv/uninstall/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -453,7 +480,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.79.0/src/commands/doc/index.ts)_
 
 ## `hereya docker run IMAGE`
 
@@ -484,7 +511,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.79.0/src/commands/docker/run/index.ts)_
 
 ## `hereya down`
 
@@ -511,7 +538,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.79.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -542,7 +569,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.79.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -569,7 +596,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.79.0/src/commands/env/set/index.ts)_
 
 ## `hereya executor start`
 
@@ -602,7 +629,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.79.0/src/commands/executor/start/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -640,7 +667,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.79.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow docker run IMAGE`
 
@@ -670,7 +697,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.79.0/src/commands/flow/docker/run/index.ts)_
 
 ## `hereya flow down`
 
@@ -704,7 +731,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.79.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -738,7 +765,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.79.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow provid PACKAGE`
 
@@ -767,7 +794,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.79.0/src/commands/flow/provid/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -797,7 +824,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.79.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -826,7 +853,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.79.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -860,7 +887,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.79.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -917,7 +944,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.79.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -951,7 +978,24 @@ 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.79.0/src/commands/init/index.ts)_
+
+## `hereya list`
+
+List your projects.
+
+```
+USAGE
+  $ hereya list
+
+DESCRIPTION
+  List your projects.
+
+EXAMPLES
+  $ hereya list
+```
+
+_See code: [src/commands/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.79.0/src/commands/list/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -980,7 +1024,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.79.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -997,7 +1041,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.79.0/src/commands/logout/index.ts)_
 
 ## `hereya provid PACKAGE`
 
@@ -1025,7 +1069,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.79.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -1048,7 +1092,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.79.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -1076,7 +1120,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.79.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -1102,7 +1146,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.79.0/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -1133,7 +1177,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.79.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -1158,7 +1202,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.79.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -1184,7 +1228,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.79.0/src/commands/undeploy/index.ts)_
 
 ## `hereya uninit PROJECT`
 
@@ -1212,7 +1256,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.79.0/src/commands/uninit/index.ts)_
 
 ## `hereya up`
 
@@ -1239,7 +1283,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.79.0/src/commands/up/index.ts)_
 
 ## `hereya update [VERSION]`
 
@@ -1261,7 +1305,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.79.0/src/commands/update/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -1286,7 +1330,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.79.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -1306,7 +1350,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.79.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -1332,7 +1376,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.79.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -1356,7 +1400,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.79.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1377,7 +1421,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.79.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace executor install`
 
@@ -1396,7 +1440,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.79.0/src/commands/workspace/executor/install/index.ts)_
 
 ## `hereya workspace executor token`
 
@@ -1413,7 +1457,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.79.0/src/commands/workspace/executor/token/index.ts)_
 
 ## `hereya workspace executor uninstall`
 
@@ -1431,7 +1475,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.79.0/src/commands/workspace/executor/uninstall/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1458,7 +1502,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.79.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1482,7 +1526,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.79.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1506,7 +1550,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.79.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1533,5 +1577,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.79.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

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

@@ -1,5 +1,5 @@
 import { Config } from '../../lib/config/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, InitProjectInput, InitProjectOutput, ListPackageVersionsOutput, 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, 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;
@@ -52,6 +52,7 @@ export declare class CloudBackend implements Backend {
     importBackend(input: ImportBackendInput): Promise<ImportBackendOutput>;
     init(input: InitProjectInput): Promise<InitProjectOutput>;
     listPackageVersions(name: string): Promise<ListPackageVersionsOutput>;
+    listProjects(): Promise<ListProjectsOutput>;
     listWorkspaces(input?: ListWorkspacesInput): Promise<string[]>;
     pollExecutorJobs(input: {
         executorId?: string;

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

@@ -250,6 +250,7 @@ export class CloudBackend {
             };
         }
         return {
+            defaultWorkspace: result.defaultWorkspace,
             found: true,
             metadata: result.metadata,
         };
@@ -452,6 +453,20 @@ export class CloudBackend {
             success: true,
         };
     }
+    async listProjects() {
+        const response = await fetch(`${this.config.url}/api/projects`, {
+            headers: { 'Authorization': `Bearer ${this.config.accessToken}` },
+            method: 'GET',
+        });
+        if (!response.ok) {
+            throw new Error(JSON.stringify(await this.safeResponseJson(response)));
+        }
+        const result = await response.json();
+        return (result.projects ?? []).map((p) => ({
+            defaultWorkspace: p.defaultWorkspace?.name ?? '-',
+            name: p.name,
+        }));
+    }
     async listWorkspaces(input) {
         const url = new URL(`${this.config.url}/api/workspaces`);
         if (input?.org) {

package/dist/backend/common.d.ts

@@ -17,6 +17,7 @@ export interface Backend {
     importBackend(input: ImportBackendInput): Promise<ImportBackendOutput>;
     init(options: InitProjectInput): Promise<InitProjectOutput>;
     listPackageVersions?(name: string): Promise<ListPackageVersionsOutput>;
+    listProjects?(): Promise<ListProjectsOutput>;
     listWorkspaces(input?: ListWorkspacesInput): Promise<string[]>;
     publishPackage?(input: PublishPackageInput): Promise<PublishPackageOutput>;
     removePackageFromWorkspace(input: RemovePackageFromWorkspaceInput): Promise<RemovePackageFromWorkspaceOutput>;
@@ -326,11 +327,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;
@@ -342,3 +344,8 @@ export type SaveProjectMetadataOutput = {
 } | {
     success: true;
 };
+export type ProjectSummary = {
+    defaultWorkspace: string;
+    name: string;
+};
+export type ListProjectsOutput = ProjectSummary[];

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/dist/commands/list/index.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class List extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/list/index.js

@@ -0,0 +1,29 @@
+import { Command } from '@oclif/core';
+import { getBackend } from '../../backend/index.js';
+export default class List extends Command {
+    static description = 'List your projects.';
+    static examples = ['<%= config.bin %> <%= command.id %>'];
+    async run() {
+        try {
+            const backend = await getBackend();
+            if (!backend.listProjects) {
+                this.error('Listing projects requires cloud backend. Run `hereya login` first.');
+            }
+            const projects = await backend.listProjects();
+            if (projects.length === 0) {
+                this.log('No projects found.');
+                return;
+            }
+            const nameWidth = Math.max(4, ...projects.map(p => p.name.length));
+            const wsWidth = Math.max(17, ...projects.map(p => p.defaultWorkspace.length));
+            this.log(`${'Name'.padEnd(nameWidth)}  ${'Default Workspace'.padEnd(wsWidth)}`);
+            this.log('-'.repeat(nameWidth + wsWidth + 2));
+            for (const project of projects) {
+                this.log(`${project.name.padEnd(nameWidth)}  ${project.defaultWorkspace.padEnd(wsWidth)}`);
+            }
+        }
+        catch (error) {
+            this.error(`Failed to list projects: ${error}`);
+        }
+    }
+}

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": {
@@ -130,12 +170,13 @@
         "index.js"
       ]
     },
-    "deploy": {
+    "delete-state": {
       "aliases": [],
       "args": {},
-      "description": "Deploy a hereya project using the project deployment package",
+      "description": "Delete the remote state of a project for a given workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> -w dev",
+        "<%= config.bin %> <%= command.id %> --workspace staging"
       ],
       "flags": {
         "chdir": {
@@ -146,21 +187,9 @@
           "multiple": false,
           "type": "option"
         },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "local": {
-          "description": "force local execution (skip remote executor)",
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to deploy the packages for",
+          "description": "workspace name",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -170,7 +199,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "deploy",
+      "id": "delete-state",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -180,17 +209,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "deploy",
+        "delete-state",
         "index.js"
       ]
     },
-    "delete-state": {
+    "deploy": {
       "aliases": [],
       "args": {},
-      "description": "Delete the remote state of a project for a given workspace",
+      "description": "Deploy a hereya project using the project deployment package",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -w dev",
-        "<%= config.bin %> <%= command.id %> --workspace staging"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "chdir": {
@@ -201,9 +229,21 @@
           "multiple": false,
           "type": "option"
         },
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "local": {
+          "description": "force local execution (skip remote executor)",
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "workspace": {
           "char": "w",
-          "description": "workspace name",
+          "description": "name of the workspace to deploy the packages for",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -213,7 +253,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "delete-state",
+      "id": "deploy",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -223,7 +263,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "delete-state",
+        "deploy",
         "index.js"
       ]
     },
@@ -559,6 +599,30 @@
         "index.js"
       ]
     },
+    "list": {
+      "aliases": [],
+      "args": {},
+      "description": "List your projects.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "list",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "list",
+        "index.js"
+      ]
+    },
     "login": {
       "aliases": [],
       "args": {
@@ -627,44 +691,27 @@
         "index.js"
       ]
     },
-    "provid": {
+    "publish": {
       "aliases": [],
-      "args": {
-        "package": {
-          "description": "Package name (e.g., hereya/postgres)",
-          "name": "package",
-          "required": true
-        }
-      },
-      "description": "Display the provisioning ID for a package",
+      "args": {},
+      "description": "Publish a package to the Hereya registry",
       "examples": [
-        "<%= config.bin %> <%= command.id %> hereya/postgres",
-        "<%= config.bin %> <%= command.id %> hereya/postgres -w dev",
-        "<%= config.bin %> <%= command.id %> hereya/postgres --workspace staging"
+        "$ hereya publish",
+        "$ hereya publish --chdir=/path/to/package"
       ],
       "flags": {
         "chdir": {
-          "char": "C",
-          "description": "Project root directory",
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n      ",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "Name of the workspace",
-          "name": "workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "provid",
+      "id": "publish",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -674,31 +721,48 @@
       "relativePath": [
         "dist",
         "commands",
-        "provid",
+        "publish",
         "index.js"
       ]
     },
-    "publish": {
+    "provid": {
       "aliases": [],
-      "args": {},
-      "description": "Publish a package to the Hereya registry",
+      "args": {
+        "package": {
+          "description": "Package name (e.g., hereya/postgres)",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Display the provisioning ID for a package",
       "examples": [
-        "$ hereya publish",
-        "$ hereya publish --chdir=/path/to/package"
+        "<%= config.bin %> <%= command.id %> hereya/postgres",
+        "<%= config.bin %> <%= command.id %> hereya/postgres -w dev",
+        "<%= config.bin %> <%= command.id %> hereya/postgres --workspace staging"
       ],
       "flags": {
         "chdir": {
-          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n      ",
+          "char": "C",
+          "description": "Project root directory",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "Name of the workspace",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "publish",
+      "id": "provid",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -708,7 +772,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "publish",
+        "provid",
         "index.js"
       ]
     },
@@ -2817,5 +2881,5 @@
       ]
     }
   },
-  "version": "0.77.5"
+  "version": "0.79.0"
 }

package/package.json

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