refactor(cli): rename ogx launch command group to ogx connect

The `launch` terminology collided conceptually with starting the server.
Rename the command subgroup to `connect`, which better describes its
purpose of connecting OGX to external services like OpenCode.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Nathan Weinberg <nweinber@redhat.com>

Author: nathan-weinberg

docs/docs/api-openai/conformance.mdx

@@ -727,7 +727,7 @@ Below is a detailed breakdown of conformance issues and missing properties for e
 | `responses.200.content.application/json.properties.output.items` | Union variants added: 8; Union variants removed: 4 | Yes |
 | `responses.200.content.application/json.properties.parallel_tool_calls` | Default changed: None -> True | Yes |
 | `responses.200.content.application/json.properties.reasoning` | Union variants added: 1; Union variants removed: 1 | Yes |
-| `responses.200.content.application/json.properties.text` | Type added: ['object']; Default changed: None -> \{'format': \{'type': 'text'\}\} | No |
+| `responses.200.content.application/json.properties.text` | Type added: ['object'] | No |
 | `responses.200.content.application/json.properties.tool_choice` | Union variants added: 3 | Yes |
 | `responses.200.content.application/json.properties.tools.items` | Union variants added: 4; Union variants removed: 1 | Yes |
 | `responses.200.content.application/json.properties.truncation` | Union variants added: 2 | Yes |

docs/docs/building_applications/opencode_integration.mdx

@@ -7,7 +7,7 @@ sidebar_position: 6
 
 # OpenCode Integration
 
-OGX includes built-in support for launching [OpenCode](https://opencode.ai), a terminal-based AI coding assistant, with a single command. All available models on your OGX server are automatically configured and ready to use.
+OGX includes built-in support for connecting [OpenCode](https://opencode.ai), a terminal-based AI coding assistant, with a single command. All available models on your OGX server are automatically configured and ready to use.
 
 ## Quick Start
 
@@ -18,25 +18,25 @@ export OPENAI_API_KEY="your-key-here"
 ogx stack run starter
 ```
 
-### 2. Launch OpenCode
+### 2. Connect OpenCode
 
 ```bash
-ogx launch opencode
+ogx connect opencode
 ```
 
 That's it. OpenCode starts with all your OGX models available and the first model pre-selected.
 
 ## How It Works
 
-The `ogx launch opencode` command:
+The `ogx connect opencode` command:
 
 1. Queries the running OGX server for available models
 2. Filters out non-LLM models (embeddings, rerankers)
 3. Generates an OpenCode provider configuration with all discovered models
 4. Launches OpenCode with the configuration via the `OPENCODE_CONFIG_CONTENT` environment variable
 
 ```
-ogx launch opencode
+ogx connect opencode
        |
        v
   GET /v1/models (discover available models)
@@ -54,7 +54,7 @@ ogx launch opencode
 ## CLI Reference
 
 ```bash
-ogx launch opencode [--model MODEL] [--host HOST] [--port PORT]
+ogx connect opencode [--model MODEL] [--host HOST] [--port PORT]
 ```
 
 **Options:**
@@ -72,13 +72,13 @@ All discovered LLM models are available in OpenCode regardless of which model is
 ### With a specific default model
 
 ```bash
-ogx launch opencode --model openai/gpt-4o
+ogx connect opencode --model openai/gpt-4o
 ```
 
 ### With a remote OGX server
 
 ```bash
-ogx launch opencode --host 192.168.1.100 --port 9000
+ogx connect opencode --host 192.168.1.100 --port 9000
 ```
 
 ### With Ollama backend
@@ -88,8 +88,8 @@ ogx launch opencode --host 192.168.1.100 --port 9000
 export OLLAMA_URL="http://localhost:11434/v1"
 ogx stack run starter
 
-# Terminal 2: Launch OpenCode
-ogx launch opencode
+# Terminal 2: Connect OpenCode
+ogx connect opencode
 ```
 
 ### With vLLM backend
@@ -99,14 +99,14 @@ ogx launch opencode
 export VLLM_URL="http://localhost:8000/v1"
 ogx stack run starter
 
-# Terminal 2: Launch OpenCode
-ogx launch opencode --model vllm/Qwen/Qwen3-8B
+# Terminal 2: Connect OpenCode
+ogx connect opencode --model vllm/Qwen/Qwen3-8B
 ```
 
 ## Prerequisites
 
 - **OpenCode** must be installed and available in your `PATH`. Install it from [opencode.ai](https://opencode.ai).
-- **OGX server** must be running before launching OpenCode. Start it with `ogx stack run` or `ogx stack letsgo`.
+- **OGX server** must be running before connecting OpenCode. Start it with `ogx stack run` or `ogx stack letsgo`.
 
 ## Troubleshooting
 

docs/docs/references/ogx_cli_reference/index.md

@@ -31,7 +31,7 @@ You have two ways to install OGX:
 ## `ogx` subcommands
 
 1. `stack`: Allows you to build a stack using the `ogx` distribution and run a OGX server. You can read more about how to build a OGX distribution in the [Build your own Distribution](../../distributions/building_distro) documentation.
-2. `launch`: Launch third-party tools configured for OGX. Currently supports `opencode`. See [OpenCode Integration](../../building_applications/opencode_integration) for details.
+2. `connect`: Connect third-party tools to the running OGX server. Currently supports `opencode`. See [OpenCode Integration](../../building_applications/opencode_integration) for details.
 
 For downloading models, we recommend using the [Hugging Face CLI](https://huggingface.co/docs/huggingface_hub/guides/cli). See [Downloading models](#downloading-models) for more information.
 
@@ -42,18 +42,18 @@ llama --help
 ```
 
 ```text
-usage: ogx [-h] {stack,launch} ...
+usage: ogx [-h] {stack,connect} ...
 
 Welcome to the OGX CLI
 
 options:
   -h, --help      show this help message and exit
 
 subcommands:
-  {stack,launch}
+  {stack,connect}
 
   stack                 Operations for the OGX / Distributions
-  launch                Launch third-party tools configured for OGX
+  connect               Connect third-party tools to the running OGX server
 ```
 
 ## Downloading models

docs/static/openai-coverage.json

@@ -1431,8 +1431,7 @@
                 {
                   "property": "POST.responses.200.content.application/json.properties.text",
                   "details": [
-                    "Type added: ['object']",
-                    "Default changed: None -> {'format': {'type': 'text'}}"
+                    "Type added: ['object']"
                   ]
                 },
                 {

src/ogx/cli/launch/__init__.py src/ogx/cli/connect/__init__.pysrc/ogx/cli/launch/__init__.py renamed to src/ogx/cli/connect/__init__.py

@@ -4,4 +4,4 @@
 # This source code is licensed under the terms described in the LICENSE file in
 # the root directory of this source tree.
 
-from .launch import LaunchParser  # noqa
+from .connect import ConnectParser  # noqa

src/ogx/cli/launch/launch.py src/ogx/cli/connect/connect.pysrc/ogx/cli/launch/launch.py renamed to src/ogx/cli/connect/connect.py

@@ -9,24 +9,27 @@
 from ogx.cli.stack.utils import print_subcommand_description
 from ogx.cli.subcommand import Subcommand
 
-from .opencode import LaunchOpenCode
+from .opencode import ConnectOpenCode
 
 
-class LaunchParser(Subcommand):
-    """Top-level CLI parser for the 'ogx launch' command group."""
+class ConnectParser(Subcommand):
+    """Top-level CLI parser for the 'ogx connect' command group.
+
+    `connect` is a command subgroup used to connect OGX to external services.
+    """
 
     def __init__(self, subparsers: argparse._SubParsersAction) -> None:
         super().__init__()
         self.parser = subparsers.add_parser(
-            "launch",
-            prog="ogx launch",
-            description="Launch third-party tools configured for OGX",
+            "connect",
+            prog="ogx connect",
+            description="Connect third-party tools to the running OGX server",
             formatter_class=argparse.RawTextHelpFormatter,
         )
 
         self.parser.set_defaults(func=lambda args: self.parser.print_help())
 
-        subparsers = self.parser.add_subparsers(title="launch_subcommands")
+        subparsers = self.parser.add_subparsers(title="connect_subcommands")
 
-        LaunchOpenCode.create(subparsers)
+        ConnectOpenCode.create(subparsers)
         print_subcommand_description(self.parser, subparsers)

src/ogx/cli/launch/opencode.py src/ogx/cli/connect/opencode.pysrc/ogx/cli/launch/opencode.py renamed to src/ogx/cli/connect/opencode.py

@@ -20,19 +20,19 @@
 logger = get_logger(name=__name__, category="cli")
 
 
-class LaunchOpenCode(Subcommand):
-    """Launch OpenCode configured to use the running OGX server."""
+class ConnectOpenCode(Subcommand):
+    """Connect OpenCode to the running OGX server."""
 
     def __init__(self, subparsers: argparse._SubParsersAction) -> None:
         super().__init__()
         self.parser = subparsers.add_parser(
             "opencode",
-            prog="ogx launch opencode",
+            prog="ogx connect opencode",
             description="Launch OpenCode connected to the running OGX server.",
             formatter_class=argparse.ArgumentDefaultsHelpFormatter,
         )
         self._add_arguments()
-        self.parser.set_defaults(func=self._run_launch_opencode_cmd)
+        self.parser.set_defaults(func=self._run_connect_opencode_cmd)
 
     def _add_arguments(self) -> None:
         self.parser.add_argument(
@@ -54,7 +54,7 @@ def _add_arguments(self) -> None:
             help="OGX server host.",
         )
 
-    def _run_launch_opencode_cmd(self, args: argparse.Namespace) -> None:
+    def _run_connect_opencode_cmd(self, args: argparse.Namespace) -> None:
         if not shutil.which("opencode"):
             cprint(
                 "Failed to find 'opencode' in PATH. Install it from https://opencode.ai",
@@ -75,7 +75,7 @@ def _run_launch_opencode_cmd(self, args: argparse.Namespace) -> None:
         config = self._build_opencode_config(base_url, models, default_model)
         config_json = json.dumps(config)
 
-        logger.info("Launching OpenCode", default_model=default_model, models=len(models), base_url=base_url)
+        logger.info("Connecting to OpenCode", default_model=default_model, models=len(models), base_url=base_url)
 
         env = {**os.environ, "OPENCODE_CONFIG_CONTENT": config_json}
         result = subprocess.run(["opencode"], env=env)

src/ogx/cli/ogx.py

@@ -12,7 +12,7 @@
 # Initialize logging early before any loggers get created
 setup_logging()
 
-from .launch import LaunchParser  # type: ignore[attr-defined]
+from .connect import ConnectParser  # type: ignore[attr-defined]
 from .letsgo import LetsGo
 from .run import Run
 from .stack import StackParser  # type: ignore[attr-defined]
@@ -39,7 +39,7 @@ def __init__(self) -> None:
         LetsGo.create(subparsers)
         Run.create(subparsers)
         StackParser.create(subparsers)
-        LaunchParser.create(subparsers)
+        ConnectParser.create(subparsers)
 
         print_subcommand_description(self.parser, subparsers)