feat: add gatway support to rli (#101)

## Description

<!-- Provide a brief description of your changes -->

**Note:** PR titles should follow [Conventional
Commits](https://www.conventionalcommits.org/) format (e.g.,
`feat(devbox): add support for custom env vars` or `fix(snapshot):
resolve pagination issue`) as they are used for automatic release notes
generation.

## Type of Change

<!-- Mark the relevant option with an 'x' -->

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [ ] Test updates

## Related Issues

<!-- Link to related issues using #issue-number -->
Closes #

## Changes Made

<!-- Describe the changes in detail -->

## Testing

<!-- Describe how you tested your changes -->

- [ ] I have tested locally
- [ ] I have added/updated tests
- [ ] All existing tests pass

## Checklist

- [ ] My code follows the code style of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have updated the documentation accordingly
- [ ] My changes generate no new warnings
- [ ] I have added tests that prove my fix is effective or that my
feature works
- [ ] New and existing unit tests pass locally with my changes
- [ ] Any dependent changes have been merged and published

## Screenshots (if applicable)

<!-- Add screenshots to help explain your changes -->

## Additional Notes

<!-- Any additional information that reviewers should know -->

Author: dines-rl

README.md

@@ -152,6 +152,16 @@ rli secret update <name>                 # Update a secret value (value from std
 rli secret delete <name>                 # Delete a secret
 ```
 
+### Gateway-config Commands (alias: `gwc`)
+
+```bash
+rli gateway-config list                  # List gateway configurations
+rli gateway-config create                # Create a new gateway configuration
+rli gateway-config get <id>              # Get gateway configuration details
+rli gateway-config update <id>           # Update a gateway configuration
+rli gateway-config delete <id>           # Delete a gateway configuration
+```
+
 ### Mcp Commands
 
 ```bash

package.json

@@ -68,7 +68,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.19.1",
-    "@runloop/api-client": "1.3.1",
+    "@runloop/api-client": "1.6.0",
     "@types/express": "^5.0.3",
     "chalk": "^5.3.0",
     "commander": "^14.0.1",

pnpm-lock.yaml

@@ -23,6 +23,7 @@ interface CreateOptions {
   root?: boolean;
   user?: string;
   networkPolicy?: string;
+  gateways?: string[];
   output?: string;
 }
 
@@ -71,6 +72,45 @@ function parseCodeMounts(codeMounts: string[]): unknown[] {
   });
 }
 
+// Parse gateways from ENV_PREFIX=gateway,secret format
+function parseGateways(
+  gateways: string[],
+): Record<string, { gateway: string; secret: string }> {
+  const result: Record<string, { gateway: string; secret: string }> = {};
+  for (const gateway of gateways) {
+    const eqIndex = gateway.indexOf("=");
+    if (eqIndex === -1) {
+      throw new Error(
+        `Invalid gateway format: ${gateway}. Expected ENV_PREFIX=gateway_id_or_name,secret_id_or_name`,
+      );
+    }
+    const envPrefix = gateway.substring(0, eqIndex);
+    const valueStr = gateway.substring(eqIndex + 1);
+
+    // Split by comma to get gateway and secret
+    const commaIndex = valueStr.indexOf(",");
+    if (commaIndex === -1) {
+      throw new Error(
+        `Invalid gateway format: ${gateway}. Expected ENV_PREFIX=gateway_id_or_name,secret_id_or_name`,
+      );
+    }
+    const gatewayIdOrName = valueStr.substring(0, commaIndex);
+    const secretIdOrName = valueStr.substring(commaIndex + 1);
+
+    if (!envPrefix || !gatewayIdOrName || !secretIdOrName) {
+      throw new Error(
+        `Invalid gateway format: ${gateway}. Expected ENV_PREFIX=gateway_id_or_name,secret_id_or_name`,
+      );
+    }
+
+    result[envPrefix] = {
+      gateway: gatewayIdOrName,
+      secret: secretIdOrName,
+    };
+  }
+  return result;
+}
+
 export async function createDevbox(options: CreateOptions = {}) {
   try {
     const client = getClient();
@@ -173,6 +213,11 @@ export async function createDevbox(options: CreateOptions = {}) {
       createRequest.secrets = parseSecrets(options.secrets);
     }
 
+    // Handle gateways
+    if (options.gateways && options.gateways.length > 0) {
+      createRequest.gateways = parseGateways(options.gateways);
+    }
+
     if (Object.keys(launchParameters).length > 0) {
       createRequest.launch_parameters = launchParameters;
     }

src/commands/devbox/create.ts

@@ -0,0 +1,58 @@
+/**
+ * Create gateway config command
+ */
+
+import { getClient } from "../../utils/client.js";
+import { output, outputError } from "../../utils/output.js";
+
+interface CreateOptions {
+  name: string;
+  endpoint: string;
+  authType: string;
+  authKey?: string;
+  description?: string;
+  output?: string;
+}
+
+export async function createGatewayConfig(options: CreateOptions) {
+  try {
+    const client = getClient();
+
+    // Validate auth type
+    const authType = options.authType.toLowerCase();
+    if (authType !== "bearer" && authType !== "header") {
+      outputError("Invalid auth type. Must be 'bearer' or 'header'");
+      return;
+    }
+
+    // Validate auth key is provided for header type
+    if (authType === "header" && !options.authKey) {
+      outputError("--auth-key is required when auth-type is 'header'");
+      return;
+    }
+
+    // Build auth mechanism
+    const authMechanism: { type: string; key?: string } = {
+      type: authType,
+    };
+    if (authType === "header" && options.authKey) {
+      authMechanism.key = options.authKey;
+    }
+
+    const config = await client.gatewayConfigs.create({
+      name: options.name,
+      endpoint: options.endpoint,
+      auth_mechanism: authMechanism,
+      description: options.description,
+    });
+
+    // Default: just output the ID for easy scripting
+    if (!options.output || options.output === "text") {
+      console.log(config.id);
+    } else {
+      output(config, { format: options.output, defaultFormat: "json" });
+    }
+  } catch (error) {
+    outputError("Failed to create gateway config", error);
+  }
+}

src/commands/gateway-config/create.ts

@@ -0,0 +1,33 @@
+/**
+ * Delete gateway config command
+ */
+
+import { getClient } from "../../utils/client.js";
+import { output, outputError } from "../../utils/output.js";
+
+interface DeleteOptions {
+  output?: string;
+}
+
+export async function deleteGatewayConfig(
+  id: string,
+  options: DeleteOptions = {},
+) {
+  try {
+    const client = getClient();
+
+    await client.gatewayConfigs.delete(id);
+
+    // Default: just output the ID for easy scripting
+    if (!options.output || options.output === "text") {
+      console.log(id);
+    } else {
+      output(
+        { id, status: "deleted" },
+        { format: options.output, defaultFormat: "json" },
+      );
+    }
+  } catch (error) {
+    outputError("Failed to delete gateway config", error);
+  }
+}

src/commands/gateway-config/delete.ts

@@ -0,0 +1,23 @@
+/**
+ * Get gateway config command
+ */
+
+import { getClient } from "../../utils/client.js";
+import { output, outputError } from "../../utils/output.js";
+
+interface GetOptions {
+  id: string;
+  output?: string;
+}
+
+export async function getGatewayConfig(options: GetOptions) {
+  try {
+    const client = getClient();
+
+    const config = await client.gatewayConfigs.retrieve(options.id);
+
+    output(config, { format: options.output, defaultFormat: "json" });
+  } catch (error) {
+    outputError("Failed to get gateway config", error);
+  }
+}