@knocklabs/cli 0.2.2 → 0.2.3

package/README.md

@@ -16,7 +16,7 @@ $ npm install -g @knocklabs/cli
 $ knock COMMAND
 running command...
 $ knock (--version)
-@knocklabs/cli/0.2.2 linux-x64 node-v18.20.8
+@knocklabs/cli/0.2.3 linux-x64 node-v18.20.8
 $ knock --help [COMMAND]
 USAGE
   $ knock COMMAND
@@ -90,7 +90,7 @@ FLAGS
       --service-token=<value>   The service token to authenticate with.
 ```
 
-_See code: [src/commands/commit/index.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/commit/index.ts)_
+_See code: [src/commands/commit/index.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/commit/index.ts)_
 
 ## `knock commit get ID`
 
@@ -107,7 +107,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/commit/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/commit/get.ts)_
+_See code: [src/commands/commit/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/commit/get.ts)_
 
 ## `knock commit list`
 
@@ -137,7 +137,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/commit/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/commit/list.ts)_
+_See code: [src/commands/commit/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/commit/list.ts)_
 
 ## `knock commit promote`
 
@@ -154,7 +154,7 @@ FLAGS
   --to=<value>             The destination environment to promote all changes from the preceding environment.
 ```
 
-_See code: [src/commands/commit/promote.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/commit/promote.ts)_
+_See code: [src/commands/commit/promote.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/commit/promote.ts)_
 
 ## `knock guide activate GUIDEKEY`
 
@@ -184,7 +184,7 @@ DESCRIPTION
   or deactivated at a later time using the --from and --until flags.
 ```
 
-_See code: [src/commands/guide/activate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/guide/activate.ts)_
+_See code: [src/commands/guide/activate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/guide/activate.ts)_
 
 ## `knock guide generate-types`
 
@@ -205,7 +205,7 @@ DESCRIPTION
   Generate types for all guides in an environment and write them to a file.
 ```
 
-_See code: [src/commands/guide/generate-types.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/guide/generate-types.ts)_
+_See code: [src/commands/guide/generate-types.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/guide/generate-types.ts)_
 
 ## `knock guide get GUIDEKEY`
 
@@ -225,7 +225,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/guide/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/guide/get.ts)_
+_See code: [src/commands/guide/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/guide/get.ts)_
 
 ## `knock guide list`
 
@@ -248,7 +248,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/guide/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/guide/list.ts)_
+_See code: [src/commands/guide/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/guide/list.ts)_
 
 ## `knock guide pull [GUIDEKEY]`
 
@@ -268,7 +268,7 @@ FLAGS
   --service-token=<value>     The service token to authenticate with.
 ```
 
-_See code: [src/commands/guide/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/guide/pull.ts)_
+_See code: [src/commands/guide/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/guide/pull.ts)_
 
 ## `knock guide push [GUIDEKEY]`
 
@@ -289,7 +289,7 @@ FLAGS
       --service-token=<value>   The service token to authenticate with.
 ```
 
-_See code: [src/commands/guide/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/guide/push.ts)_
+_See code: [src/commands/guide/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/guide/push.ts)_
 
 ## `knock guide validate [GUIDEKEY]`
 
@@ -308,7 +308,7 @@ FLAGS
   --service-token=<value>  The service token to authenticate with.
 ```
 
-_See code: [src/commands/guide/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/guide/validate.ts)_
+_See code: [src/commands/guide/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/guide/validate.ts)_
 
 ## `knock help [COMMAND]`
 
@@ -348,7 +348,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/layout/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/layout/get.ts)_
+_See code: [src/commands/layout/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/layout/get.ts)_
 
 ## `knock layout list`
 
@@ -371,7 +371,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/layout/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/layout/list.ts)_
+_See code: [src/commands/layout/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/layout/list.ts)_
 
 ## `knock layout pull [EMAILLAYOUTKEY]`
 
@@ -391,7 +391,7 @@ FLAGS
   --service-token=<value>     The service token to authenticate with.
 ```
 
-_See code: [src/commands/layout/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/layout/pull.ts)_
+_See code: [src/commands/layout/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/layout/pull.ts)_
 
 ## `knock layout push [EMAILLAYOUTKEY]`
 
@@ -413,7 +413,7 @@ FLAGS
       --service-token=<value>   The service token to authenticate with.
 ```
 
-_See code: [src/commands/layout/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/layout/push.ts)_
+_See code: [src/commands/layout/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/layout/push.ts)_
 
 ## `knock layout validate [EMAILLAYOUTKEY]`
 
@@ -432,7 +432,7 @@ FLAGS
   --service-token=<value>  The service token to authenticate with.
 ```
 
-_See code: [src/commands/layout/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/layout/validate.ts)_
+_See code: [src/commands/layout/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/layout/validate.ts)_
 
 ## `knock login`
 
@@ -446,7 +446,7 @@ FLAGS
   --service-token=<value>  The service token to authenticate with.
 ```
 
-_See code: [src/commands/login.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/login.ts)_
 
 ## `knock logout`
 
@@ -460,7 +460,7 @@ FLAGS
   --service-token=<value>  The service token to authenticate with.
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/logout.ts)_
 
 ## `knock message-type get MESSAGETYPEKEY`
 
@@ -480,7 +480,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/message-type/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/message-type/get.ts)_
+_See code: [src/commands/message-type/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/message-type/get.ts)_
 
 ## `knock message-type list`
 
@@ -503,7 +503,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/message-type/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/message-type/list.ts)_
+_See code: [src/commands/message-type/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/message-type/list.ts)_
 
 ## `knock message-type pull [MESSAGETYPEKEY]`
 
@@ -523,7 +523,7 @@ FLAGS
   --service-token=<value>      The service token to authenticate with.
 ```
 
-_See code: [src/commands/message-type/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/message-type/pull.ts)_
+_See code: [src/commands/message-type/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/message-type/pull.ts)_
 
 ## `knock message-type push [MESSAGETYPEKEY]`
 
@@ -545,7 +545,7 @@ FLAGS
       --service-token=<value>      The service token to authenticate with.
 ```
 
-_See code: [src/commands/message-type/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/message-type/push.ts)_
+_See code: [src/commands/message-type/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/message-type/push.ts)_
 
 ## `knock message-type validate [MESSAGETYPEKEY]`
 
@@ -565,7 +565,7 @@ FLAGS
   --service-token=<value>      The service token to authenticate with.
 ```
 
-_See code: [src/commands/message-type/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/message-type/validate.ts)_
+_See code: [src/commands/message-type/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/message-type/validate.ts)_
 
 ## `knock partial get PARTIALKEY`
 
@@ -585,7 +585,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/partial/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/partial/get.ts)_
+_See code: [src/commands/partial/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/partial/get.ts)_
 
 ## `knock partial list`
 
@@ -608,7 +608,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/partial/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/partial/list.ts)_
+_See code: [src/commands/partial/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/partial/list.ts)_
 
 ## `knock partial pull [PARTIALKEY]`
 
@@ -628,7 +628,7 @@ FLAGS
   --service-token=<value>     The service token to authenticate with.
 ```
 
-_See code: [src/commands/partial/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/partial/pull.ts)_
+_See code: [src/commands/partial/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/partial/pull.ts)_
 
 ## `knock partial push [PARTIALKEY]`
 
@@ -649,7 +649,7 @@ FLAGS
       --service-token=<value>   The service token to authenticate with.
 ```
 
-_See code: [src/commands/partial/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/partial/push.ts)_
+_See code: [src/commands/partial/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/partial/push.ts)_
 
 ## `knock partial validate [PARTIALKEY]`
 
@@ -668,7 +668,7 @@ FLAGS
   --service-token=<value>  The service token to authenticate with.
 ```
 
-_See code: [src/commands/partial/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/partial/validate.ts)_
+_See code: [src/commands/partial/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/partial/validate.ts)_
 
 ## `knock pull`
 
@@ -687,7 +687,7 @@ FLAGS
   --service-token=<value>     The service token to authenticate with.
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/pull.ts)_
 
 ## `knock push`
 
@@ -707,7 +707,7 @@ FLAGS
       --service-token=<value>   The service token to authenticate with.
 ```
 
-_See code: [src/commands/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/push.ts)_
 
 ## `knock translation get TRANSLATIONREF`
 
@@ -734,7 +734,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/translation/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/translation/get.ts)_
+_See code: [src/commands/translation/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/translation/get.ts)_
 
 ## `knock translation list`
 
@@ -757,7 +757,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/translation/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/translation/list.ts)_
+_See code: [src/commands/translation/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/translation/list.ts)_
 
 ## `knock translation pull [TRANSLATIONREF]`
 
@@ -784,7 +784,7 @@ FLAGS
   --translations-dir=<value>  The target directory path to pull all translations into.
 ```
 
-_See code: [src/commands/translation/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/translation/pull.ts)_
+_See code: [src/commands/translation/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/translation/pull.ts)_
 
 ## `knock translation push [TRANSLATIONREF]`
 
@@ -811,7 +811,7 @@ FLAGS
       --translations-dir=<value>  The target directory path to find all translations to push.
 ```
 
-_See code: [src/commands/translation/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/translation/push.ts)_
+_See code: [src/commands/translation/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/translation/push.ts)_
 
 ## `knock translation validate [TRANSLATIONREF]`
 
@@ -836,7 +836,7 @@ FLAGS
   --translations-dir=<value>  The target directory path to find all translations to validate.
 ```
 
-_See code: [src/commands/translation/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/translation/validate.ts)_
+_See code: [src/commands/translation/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/translation/validate.ts)_
 
 ## `knock whoami`
 
@@ -853,7 +853,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/whoami.ts)_
 
 ## `knock workflow activate WORKFLOWKEY`
 
@@ -880,7 +880,7 @@ DESCRIPTION
   with `false` in order to deactivate it.
 ```
 
-_See code: [src/commands/workflow/activate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/workflow/activate.ts)_
+_See code: [src/commands/workflow/activate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/workflow/activate.ts)_
 
 ## `knock workflow generate-types`
 
@@ -901,7 +901,7 @@ DESCRIPTION
   Generate types for all workflows in an environment and write them to a file.
 ```
 
-_See code: [src/commands/workflow/generate-types.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/workflow/generate-types.ts)_
+_See code: [src/commands/workflow/generate-types.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/workflow/generate-types.ts)_
 
 ## `knock workflow get WORKFLOWKEY`
 
@@ -921,7 +921,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/workflow/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/workflow/get.ts)_
+_See code: [src/commands/workflow/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/workflow/get.ts)_
 
 ## `knock workflow list`
 
@@ -944,7 +944,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/workflow/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/workflow/list.ts)_
+_See code: [src/commands/workflow/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/workflow/list.ts)_
 
 ## `knock workflow pull [WORKFLOWKEY]`
 
@@ -964,7 +964,7 @@ FLAGS
   --workflows-dir=<value>     The target directory path to pull all workflows into.
 ```
 
-_See code: [src/commands/workflow/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/workflow/pull.ts)_
+_See code: [src/commands/workflow/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/workflow/pull.ts)_
 
 ## `knock workflow push [WORKFLOWKEY]`
 
@@ -985,7 +985,7 @@ FLAGS
       --workflows-dir=<value>   The target directory path to find all workflows to push.
 ```
 
-_See code: [src/commands/workflow/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/workflow/push.ts)_
+_See code: [src/commands/workflow/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/workflow/push.ts)_
 
 ## `knock workflow run WORKFLOWKEY`
 
@@ -1006,7 +1006,7 @@ FLAGS
   --tenant=<value>         A tenant id for the workflow run.
 ```
 
-_See code: [src/commands/workflow/run.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/workflow/run.ts)_
+_See code: [src/commands/workflow/run.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/workflow/run.ts)_
 
 ## `knock workflow validate [WORKFLOWKEY]`
 
@@ -1025,5 +1025,5 @@ FLAGS
   --workflows-dir=<value>  The target directory path to find all workflows to validate.
 ```
 
-_See code: [src/commands/workflow/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.2/src/commands/workflow/validate.ts)_
+_See code: [src/commands/workflow/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.2.3/src/commands/workflow/validate.ts)_
 <!-- commandsstop -->

package/dist/commands/branch/exit.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return BranchExit;
+    }
+});
+const _findup = /*#__PURE__*/ _interop_require_default(require("find-up"));
+const _basecommand = /*#__PURE__*/ _interop_require_default(require("../../lib/base-command"));
+const _branch = require("../../lib/helpers/branch");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+class BranchExit extends _basecommand.default {
+    async run() {
+        const branchFilePath = await (0, _findup.default)(_branch.BRANCH_FILE_NAME);
+        if (!branchFilePath) {
+            throw new Error(`No ${_branch.BRANCH_FILE_NAME} file found. Run \`knock branch switch\` to start working on a branch.`);
+        }
+        await (0, _branch.clearBranchFile)(branchFilePath);
+        this.log("‣ Successfully exited the branch");
+    }
+}
+// Hide until branches are released in GA
+_define_property(BranchExit, "hidden", true);
+_define_property(BranchExit, "summary", "Exits the current branch.");

package/dist/commands/branch/switch.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return BranchSwitch;
+    }
+});
+const _nodepath = /*#__PURE__*/ _interop_require_wildcard(require("node:path"));
+const _core = require("@oclif/core");
+const _findup = /*#__PURE__*/ _interop_require_default(require("find-up"));
+const _fsextra = /*#__PURE__*/ _interop_require_wildcard(require("fs-extra"));
+const _basecommand = /*#__PURE__*/ _interop_require_default(require("../../lib/base-command"));
+const _arg = require("../../lib/helpers/arg");
+const _branch = require("../../lib/helpers/branch");
+const _error = require("../../lib/helpers/error");
+const _git = require("../../lib/helpers/git");
+const _request = require("../../lib/helpers/request");
+const _ux = require("../../lib/helpers/ux");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+class BranchSwitch extends _basecommand.default {
+    async run() {
+        const { args } = this.props;
+        const currDir = process.cwd();
+        let branchFilePath = await (0, _findup.default)(_branch.BRANCH_FILE_NAME, {
+            cwd: currDir
+        });
+        if (!branchFilePath) {
+            const projectRoot = await (0, _branch.findProjectRoot)();
+            branchFilePath = await this.promptToCreateBranchFile(projectRoot);
+            // User declined to create the branch file
+            if (!branchFilePath) return;
+            const isBranchFileIgnoredByGit = await (0, _git.isFileIgnoredByGit)(projectRoot, branchFilePath);
+            if (!isBranchFileIgnoredByGit) {
+                await this.promptToUpdateGitIgnoreFile(projectRoot);
+            }
+        }
+        await this.switchToBranch(branchFilePath, args.slug);
+    }
+    async promptToCreateBranchFile(projectRoot) {
+        const { flags } = this.props;
+        const prompt = `Create \`${_branch.BRANCH_FILE_NAME}\` at ${projectRoot}?`;
+        const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
+        if (!input) return undefined;
+        return _nodepath.resolve(projectRoot, _branch.BRANCH_FILE_NAME);
+    }
+    async promptToUpdateGitIgnoreFile(projectRoot) {
+        const { flags } = this.props;
+        const gitIgnoreFilePath = _nodepath.resolve(projectRoot, ".gitignore");
+        const gitIgnoreFileExists = await _fsextra.exists(gitIgnoreFilePath);
+        const prompt = gitIgnoreFileExists ? `Update \`${gitIgnoreFilePath}\` to ignore \`${_branch.BRANCH_FILE_NAME}\`?` : `Create \`${gitIgnoreFilePath}\` to ignore \`${_branch.BRANCH_FILE_NAME}\`?`;
+        const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
+        if (!input) return;
+        await (0, _branch.appendBranchFileToGitIgnore)(gitIgnoreFilePath, gitIgnoreFileExists);
+    }
+    async switchToBranch(branchFilePath, slug) {
+        this.log(`‣ Switching to branch \`${slug}\``);
+        const branch = await this.resolveBranch(slug);
+        await (0, _branch.writeSlugToBranchFile)(branchFilePath, branch.slug);
+        this.log(`‣ Successfully switched to branch \`${branch.slug}\``);
+    }
+    async resolveBranch(slug) {
+        const { flags } = this.props;
+        try {
+            return await this.fetchBranch(slug);
+        } catch (error) {
+            // Create the branch when --create flag is provided and the branch is not found
+            if (flags.create && error instanceof _error.ApiError && error.status === 404 && error.code === "branch_not_found") {
+                return this.createBranch(slug);
+            }
+            throw error;
+        }
+    }
+    async fetchBranch(slug) {
+        return (0, _request.withSpinnerV2)(()=>this.apiV1.mgmtClient.get(`/v1/branches/${slug}`), {
+            action: "‣ Fetching branch"
+        });
+    }
+    async createBranch(slug) {
+        return (0, _request.withSpinnerV2)(()=>this.apiV1.mgmtClient.post(`/v1/branches/${slug}`), {
+            action: "‣ Creating branch"
+        });
+    }
+}
+// Hide until branches are released in GA
+_define_property(BranchSwitch, "hidden", true);
+_define_property(BranchSwitch, "summary", "Switches to an existing branch with the given slug.");
+_define_property(BranchSwitch, "flags", {
+    create: _core.Flags.boolean({
+        summary: "Create the branch if it doesn't yet exist."
+    }),
+    force: _core.Flags.boolean({
+        summary: "Remove the confirmation prompt."
+    })
+});
+_define_property(BranchSwitch, "args", {
+    slug: _arg.CustomArgs.slug({
+        required: true,
+        description: "The slug of the branch to switch to"
+    })
+});

package/dist/lib/helpers/branch.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get BRANCH_FILE_NAME () {
+        return BRANCH_FILE_NAME;
+    },
+    get appendBranchFileToGitIgnore () {
+        return appendBranchFileToGitIgnore;
+    },
+    get clearBranchFile () {
+        return clearBranchFile;
+    },
+    get findProjectRoot () {
+        return findProjectRoot;
+    },
+    get parseSlugFromBranchFile () {
+        return parseSlugFromBranchFile;
+    },
+    get readSlugFromBranchFile () {
+        return readSlugFromBranchFile;
+    },
+    get writeSlugToBranchFile () {
+        return writeSlugToBranchFile;
+    }
+});
+const _nodepath = /*#__PURE__*/ _interop_require_default(require("node:path"));
+const _findup = /*#__PURE__*/ _interop_require_default(require("find-up"));
+const _fsextra = /*#__PURE__*/ _interop_require_wildcard(require("fs-extra"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+const BRANCH_FILE_NAME = ".knockbranch";
+/**
+ * A comment written to the `.gitignore` file when it's updated.
+ */ const GITIGNORE_COMMENT = "# Knock CLI config files\n";
+const readSlugFromBranchFile = async ()=>{
+    const branchFilePath = await (0, _findup.default)(BRANCH_FILE_NAME);
+    const slug = branchFilePath ? await parseSlugFromBranchFile(branchFilePath) : undefined;
+    return slug;
+};
+const parseSlugFromBranchFile = async (branchFilePath)=>{
+    const input = (await _fsextra.readFile(branchFilePath, "utf-8")).trim();
+    return /^[\w-]+$/.test(input) ? input : undefined;
+};
+const clearBranchFile = async (branchFilePath)=>{
+    // The empty string indicates that no branch is currently active
+    await _fsextra.writeFile(branchFilePath, "");
+};
+const writeSlugToBranchFile = async (branchFilePath, branchSlug)=>{
+    await _fsextra.writeFile(branchFilePath, `${branchSlug}\n`);
+};
+const findProjectRoot = async ()=>{
+    const currDir = process.cwd();
+    const gitIgnoreFilePath = await (0, _findup.default)(async (directory)=>{
+        const filePath = _nodepath.default.join(directory, ".gitignore");
+        const gitIgnoreFileExists = await _fsextra.exists(filePath);
+        if (gitIgnoreFileExists) {
+            return filePath;
+        }
+        // Stop search when we find a .git directory
+        const gitDirExists = await _fsextra.exists(_nodepath.default.join(directory, ".git"));
+        if (gitDirExists) {
+            return _findup.default.stop;
+        }
+    }, {
+        cwd: currDir
+    });
+    return gitIgnoreFilePath ? _nodepath.default.dirname(gitIgnoreFilePath) : currDir;
+};
+const appendBranchFileToGitIgnore = async (gitIgnoreFilePath, addLeadingNewline = true)=>{
+    const appendedContent = (addLeadingNewline ? "\n" : "") + GITIGNORE_COMMENT + BRANCH_FILE_NAME + "\n";
+    await _fsextra.appendFile(gitIgnoreFilePath, appendedContent);
+};

package/dist/lib/helpers/error.js

@@ -58,6 +58,11 @@ class CustomError extends Error {
     }
 }
 class ApiError extends CustomError {
+    constructor(message, status, code){
+        super(message), _define_property(this, "status", void 0), _define_property(this, "code", void 0);
+        this.status = status;
+        this.code = code;
+    }
 }
 class JsonSyntaxError extends CustomError {
 }

package/dist/lib/helpers/flag.js

@@ -34,6 +34,8 @@ _export(exports, {
 const _nodepath = /*#__PURE__*/ _interop_require_wildcard(require("node:path"));
 const _core = require("@oclif/core");
 const _fsextra = /*#__PURE__*/ _interop_require_wildcard(require("fs-extra"));
+const _lodash = require("lodash");
+const _branch = require("./branch");
 const _json = require("./json");
 const _string = require("./string");
 function _getRequireWildcardCache(nodeInterop) {
@@ -147,5 +149,8 @@ const slug = _core.Flags.custom({
 const branch = slug({
     summary: "The slug of the branch to use.",
     // TODO Hide until branching is released in GA
-    hidden: true
+    hidden: true,
+    // Memoize this flag's default. oclif runs this default function even when the flag is unused.
+    // Using lodash's once avoids unnecessarily reading the branch file multiple times.
+    default: (0, _lodash.once)(_branch.readSlugFromBranchFile)
 });

package/dist/lib/helpers/git.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "isFileIgnoredByGit", {
+    enumerable: true,
+    get: function() {
+        return isFileIgnoredByGit;
+    }
+});
+const _nodechild_process = require("node:child_process");
+const isFileIgnoredByGit = async (currDir, filePath)=>{
+    try {
+        (0, _nodechild_process.execSync)(`git check-ignore "${filePath}"`, {
+            cwd: currDir,
+            // Suppress output since we only care about exit status
+            stdio: "pipe"
+        });
+        // If we reach here, git check-ignore returned exit status 0 (file is ignored)
+        // See https://git-scm.com/docs/git-check-ignore#_exit_status
+        return true;
+    } catch  {
+        return false;
+    }
+};

package/dist/lib/helpers/request.js

@@ -90,7 +90,7 @@ const withSpinnerV2 = async (requestFn, opts = {})=>{
     } catch (error) {
         if (error instanceof _mgmt.default.APIError) {
             const message = formatMgmtError(error);
-            return _core.ux.error(new _error.ApiError(message));
+            return _core.ux.error(new _error.ApiError(message, error.status, error.error.code));
         }
         throw error;
     }

package/dist/lib/marshal/translation/helpers.js

@@ -178,7 +178,7 @@ const ensureValidCommandTarget = async (props, runContext)=>{
     if (resourceDirCtx && resourceDirCtx.key !== localeCode) {
         return _core.ux.error(`Cannot run ${commandId} with \`${args.translationRef}\` inside a ${resourceDirCtx.key} directory`);
     }
-    const targetDirPath = resourceDirCtx ? resourceDirCtx.abspath : _nodepath.resolve(runCwd, localeCode);
+    const targetDirPath = resourceDirCtx ? resourceDirCtx.abspath : flags["translations-dir"] ? _nodepath.resolve(flags["translations-dir"].abspath, localeCode) : _nodepath.resolve(runCwd, localeCode);
     // Got translationRef arg but no --all flag, which means target only a single
     // translation file.
     if (!flags.all) {

package/oclif.manifest.json

@@ -420,6 +420,46 @@
         "delete.js"
       ]
     },
+    "branch:exit": {
+      "aliases": [],
+      "args": {},
+      "flags": {
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "branch:exit",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Exits the current branch.",
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "branch",
+        "exit.js"
+      ]
+    },
     "branch:list": {
       "aliases": [],
       "args": {},
@@ -488,6 +528,64 @@
         "list.js"
       ]
     },
+    "branch:switch": {
+      "aliases": [],
+      "args": {
+        "slug": {
+          "description": "The slug of the branch to switch to",
+          "name": "slug",
+          "required": true
+        }
+      },
+      "flags": {
+        "service-token": {
+          "env": "KNOCK_SERVICE_TOKEN",
+          "name": "service-token",
+          "required": false,
+          "summary": "The service token to authenticate with.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-origin": {
+          "hidden": true,
+          "name": "api-origin",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "create": {
+          "name": "create",
+          "summary": "Create the branch if it doesn't yet exist.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "name": "force",
+          "summary": "Remove the confirmation prompt.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "branch:switch",
+      "pluginAlias": "@knocklabs/cli",
+      "pluginName": "@knocklabs/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Switches to an existing branch with the given slug.",
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "branch",
+        "switch.js"
+      ]
+    },
     "commit:get": {
       "aliases": [],
       "args": {
@@ -3826,5 +3924,5 @@
       ]
     }
   },
-  "version": "0.2.2"
+  "version": "0.2.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Knock CLI",
   "author": "@knocklabs",
   "bin": {
@@ -24,13 +24,14 @@
     "axios": "^1.11.0",
     "date-fns": "^2.30.0",
     "enquirer": "^2.4.1",
+    "find-up": "^5.0.0",
     "fs-extra": "^11.3.2",
     "liquidjs": "^10.21.1",
     "locale-codes": "^1.3.1",
     "lodash": "^4.17.21",
     "open": "8.4.2",
     "quicktype-core": "^23.2.6",
-    "zod": "^4.1.11"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
     "@oclif/test": "^3",
@@ -57,7 +58,7 @@
     "ts-node": "^10.9.1",
     "tsconfig-paths": "^4.2.0",
     "tslib": "^2.8.1",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   },
   "oclif": {
     "bin": "knock",