Cleanup CLI docs (remove chat, sidebar, nightly)

Author: gabrielle-ong

docs/docs/cli/chat.mdx

@@ -7,12 +7,8 @@ slug: /cli
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-:::warning
-🚧 Cortex.cpp is currently under development. Our documentation outlines the intended behavior of Cortex, which may not yet be fully implemented in the codebase.
-:::
-
-# Cortex
-This command list all the available commands within the Cortex.cpp commands.
+# `cortex`
+This command list all the available commands within the Cortex commands.
 
 ## Usage
 :::info
@@ -21,48 +17,23 @@ You can use the `--verbose` flag to display more detailed output of the internal
 <Tabs>
   <TabItem value="MacOs/Linux" label="MacOs/Linux">
   ```sh
-  # Stable
   cortex
-
-  # Beta
-  cortex-beta
-
-  # Nightly
-  cortex-nightly
   ```
   </TabItem>
   <TabItem value="Windows" label="Windows">
   ```sh
-  # Stable
   cortex.exe
-
-  # Beta
-  cortex-beta.exe
-
-  # Nightly
-  cortex-nightly.exe
   ```
   </TabItem>
 </Tabs>
 
-
-## Command Chaining
-Cortex CLI's command chaining support allows multiple commands to be executed in sequence with a simplified syntax.
-
-For example:
-
-- [cortex run](/docs/cli/run)
-- [cortex chat](/docs/cli/chat)
-
 ## Sub Commands
 
+- [cortex start](/docs/cli/start): Start the Cortex API server (starts automatically with other commands)
+- [cortex run](/docs/cli/run): Shortcut for `cortex models start`. Pull a remote model or start a local model, and start chatting.
+- [cortex pull](/docs/cli/pull): Download a model.
 - [cortex models](/docs/cli/models): Manage and configure models.
-- [cortex chat](/docs/cli/chat): Send a chat request to a model.
 - [cortex ps](/docs/cli/ps): Display active models and their operational status.
-- [cortex embeddings](/docs/cli/embeddings): Create an embedding vector representing the input text.
-- [cortex engines](/docs/cli/engines): Manage Cortex.cpp engines.
-- [cortex pull|download](/docs/cli/pull): Download a model.
-- [cortex run](/docs/cli/run): Shortcut to pull, start and chat with a model.
-- [cortex update](/docs/cli/update): Update the Cortex.cpp version.
-- [cortex start](/docs/cli/start): Start the Cortex.cpp API server.
-- [cortex stop](/docs/cli/stop): Stop the Cortex.cpp API server.
+- [cortex engines](/docs/cli/engines): Manage Cortex engines.
+- [cortex update](/docs/cli/update): Update the Cortex version.
+- [cortex stop](/docs/cli/stop): Stop the Cortex API server.

docs/docs/cli/cortex.mdx

@@ -7,59 +7,42 @@ slug: "ps"
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-:::warning
-🚧 Cortex.cpp is currently under development. Our documentation outlines the intended behavior of Cortex, which may not yet be fully implemented in the codebase.
-:::
-
 # `cortex ps`
 
-This command shows the running model and its status.
-
-
+This command shows the running model and its status (Engine, RAM, VRAM, and Uptime).
 
 ## Usage
-:::info
-You can use the `--verbose` flag to display more detailed output of the internal processes. To apply this flag, use the following format: `cortex --verbose [subcommand]`.
-:::
 <Tabs>
   <TabItem value="MacOs/Linux" label="MacOs/Linux">
   ```sh
-  # Stable
   cortex ps [options]
-
-  # Beta
-  cortex-beta ps [options]
-
-  # Nightly
-  cortex-nightly ps [options]
   ```
   </TabItem>
   <TabItem value="Windows" label="Windows">
   ```sh
-  # Stable
   cortex.exe ps [options]
-  
-  # Beta
-  cortex-beta.exe ps [options]
-
-  # Nightly
-  cortex-nightly.exe ps [options]
   ```
   </TabItem>
 </Tabs>
 
-
 For example, it returns the following table:
 
 ```bash
-+----------------+-----------+----------+-----------+-----------+
-| Model          | Engine    | RAM      | VRAM      | Up time   |
-+----------------+-----------+----------+-----------+-----------+
-| tinyllama:gguf | llama-cpp | 35.16 MB | 601.02 MB | 5 seconds |
-+----------------+-----------+----------+-----------+-----------+
+> cortex ps
++------------------------+-----------+-----------+-----------+-------------------------------+
+| Model                  | Engine    | RAM       | VRAM      | Uptime                        |
++------------------------+-----------+-----------+-----------+-------------------------------+
+| llama3.2:3b-gguf-q4-km | llama-cpp | 308.23 MB | 1.87 GB   | 7 seconds                     |
++------------------------+-----------+-----------+-----------+-------------------------------+
+| tinyllama:1b-gguf      | llama-cpp | 35.16 MB  | 636.18 MB | 1 hour, 5 minutes, 45 seconds |
++------------------------+-----------+-----------+-----------+-------------------------------+
 ```
 ## Options
 
 | Option            | Description                                           | Required | Default value | Example     |
 |-------------------|-------------------------------------------------------|----------|---------------|-------------|
-| `-h`, `--help`      | Display help information for the command.             | No       | -             | `-h`    |
+| `-h`, `--help`      | Display help information for the command.             | No       | -             | `-h`    |
+
+:::info
+You can use the `--verbose` flag to display more detailed output of the internal processes. To apply this flag, use the following format: `cortex --verbose [subcommand]`.
+:::

docs/docs/cli/ps.mdx

@@ -7,18 +7,23 @@ slug: "pull"
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-:::warning
-🚧 Cortex.cpp is currently under development. Our documentation outlines the intended behavior of Cortex, which may not yet be fully implemented in the codebase.
-:::
-
 # `cortex pull`
 :::info
 This CLI command calls the following API endpoint:
 - [Download Model](/api-reference#tag/models/post/v1/models/{modelId}/pull)
 :::
-This command downloads models from supported [model repositories](/docs/model-sources).
+This command displays downloaded models, or displays models available for downloading. 
+
+There are 3 ways to download models:
+- From Cortex's [Built-in models](/docs/hub/cortex-hub): `cortex pull <model_name>`
+- HuggingFace repository handle: `cortex pull <author/RepoID>`
+- HuggingFace direct URL: `cortex pull <huggingface URL ending with .gguf>`
+
+Each of these will display the model quantizations available, to be selected for download.
+
+For more information, please refer to [Pulling Models](docs/hub/index).
 
-The downloaded model will be stored in the Cortex folder in your home data directory.
+The downloaded model file will be stored in the [Cortex Data Folder](/docs/architecture/data-folder).
 
 
 ## Usage
@@ -28,34 +33,39 @@ You can use the `--verbose` flag to display more detailed output of the internal
 <Tabs>
   <TabItem value="MacOs/Linux" label="MacOs/Linux">
   ```sh
-  # Stable
   cortex pull [options] <model_id> 
-
-  # Beta
-  cortex-beta pull [options] <model_id> 
-
-  # Nightly
-  cortex-nightly pull [options] <model_id> 
   ```
   </TabItem>
   <TabItem value="Windows" label="Windows">
   ```sh
-  # Stable
   cortex.exe pull [options] <model_id> 
-  
-  # Beta
-  cortex-beta.exe pull [options] <model_id> 
-
-  # Nightly
-  cortex-nightly.exe pull [options] <model_id> 
   ```
   </TabItem>
 </Tabs>
 
+For example, this returns the following:
+```bash
+> cortex-nightly pull llama3.2
+Downloaded models:
+    llama3.2:3b-gguf-q4-km
+
+Available to download:
+    1. llama3.2:3b-gguf-q2-k
+    2. llama3.2:3b-gguf-q3-kl
+    3. llama3.2:3b-gguf-q3-km
+    4. llama3.2:3b-gguf-q3-ks
+    5. llama3.2:3b-gguf-q4-ks
+    6. llama3.2:3b-gguf-q5-km
+    7. llama3.2:3b-gguf-q5-ks
+    8. llama3.2:3b-gguf-q6-k
+    9. llama3.2:3b-gguf-q8-0
+
+Select a model (1-9):
+```
 
 ## Options
 
 | Option         | Description                                       | Required | Default value | Example     |
 | -------------- | ------------------------------------------------- | -------- | ------------- | ----------- |
-| `model_id`     | The identifier of the model you want to download. | Yes      | -             | `mistral` |
-| `-h`, `--help` | Display help information for the command.         | No       | -             | `-h`        |
+| `model_id`     | The identifier of the model you want to download. You can use the [Built-in models](/docs/hub/cortex-hub) or Supported [HuggingFace models](/docs/hub/hugging-face). | Yes      | -             | `mistral` |
+| `-h`, `--help` | Display help information for the command.         | No       | -             | `-h`        |

docs/docs/cli/pull.mdx

@@ -7,75 +7,35 @@ slug: "run"
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-:::warning
-🚧 Cortex.cpp is currently under development. Our documentation outlines the intended behavior of Cortex, which may not yet be fully implemented in the codebase.
-:::
-
 # `cortex run`
-:::info
-This CLI command calls the following API endpoint:
-- [Download Model](/api-reference#tag/models/post/v1/models/pull) (The command only calls this endpoint if the specified model is not downloaded yet.)
-- Install Engine (The command only calls this endpoint if the specified engine is not downloaded yet.)
-- [Start Model](/api-reference#tag/models/post/v1/models/start)
-:::
 
-This command facilitates the initiation of starting a specified machine-learning model.
+This CLI command is a shortcut to run models easily. It executes this sequence of commands:
+1. [`cortex pull`](/docs/cli/models/): This command pulls the specified model if the model is not yet downloaded, or finds a local model.
+2. [`cortex engines install`](/docs/cli/engines/): This command installs the specified engines if not yet downloaded.
+3. [`cortex models start`](/docs/cli/models/): This command starts the specified model, making it active and ready for interactions.
 
 ## Usage
 :::info
 You can use the `--verbose` flag to display more detailed output of the internal processes. To apply this flag, use the following format: `cortex --verbose [subcommand]`.
 :::
+
 <Tabs>
   <TabItem value="MacOs/Linux" label="MacOs/Linux">
   ```sh
-  # Stable
-  cortex [options] <model_id>:[engine]
-
-  # Beta
-  cortex-beta [options] <model_id>:[engine]
-
-  # Nightly
-  cortex-nightly [options] <model_id>:[engine]
+  cortex [options] <model_id>
   ```
   </TabItem>
   <TabItem value="Windows" label="Windows">
   ```sh
-  # Stable
-  cortex.exe [options] <model_id>:[engine]
-  
-  # Beta
-  cortex-beta.exe [options] <model_id>:[engine]
-
-  # Nightly
-  cortex-nightly.exe [options] <model_id>:[engine]
+  cortex.exe [options] <model_id>
   ```
   </TabItem>
 </Tabs>
 
-### `model_id`
-You can use the [Built-in models](/docs/hub/cortex-hub) or Supported [HuggingFace models](/docs/hub/hugging-face).
-
-:::info
-This command downloads and installs the model if not already available in your file system, then starts it for interaction.
-:::
-
-
 ## Options
 
 | Option                      | Description                                                                 | Required | Default value                                | Example                |
 |-----------------------------|-----------------------------------------------------------------------------|----------|----------------------------------------------|------------------------|
-| `model_id`                  | The identifier of the model you want to chat with.                          | Yes       | `Prompt to select from the available models` | `mistral`       |
-| `-h`, `--help`                | Display help information for the command.                                   | No       | -                                            | `-h`               |
-<!-- | `-t`, `--thread <thread_id>`  | Specify the Thread ID. Defaults to creating a new thread if none specified. | No       | -                                            | `-t jan_1717650808`       |
-| `-p`, `--preset`              | Apply a chat preset to the chat session.                                    | No       | -                                            | `-p friendly`    |
-| `-c`, `--chat`                | Start a chat session after running the model.                                   | No       | -                                            | `-c`               | -->
-
-
-
-## Command Chain
-
-`cortex run` command is a convenience wrapper that automatically executes a sequence of commands to simplify user interactions:
-
-1. [`cortex pull`](/docs/cli/models/): This command pulls the specified model if the model is not yet downloaded.
-2. [`cortex engines install`](/docs/cli/engines/): This command installs the specified engines if not yet downloaded.
-3. [`cortex models start`](/docs/cli/models/): This command starts the specified model, making it active and ready for interactions.
+| `model_id`                  | The identifier of the model you want to chat with. You can use the [Built-in models](/docs/hub/cortex-hub) or Supported [HuggingFace models](/docs/hub/hugging-face).                     | Yes       | - | `mistral`       |
+| `-h`, `--help`              | Display help information for the command.                                   | No       | -                                            | `-h`               |
+<!-- | `-t`, `--thread <thread_id>`  | Specify the Thread ID. Defaults to creating a new thread if none specified. | No       | -                                            | `-t jan_1717650808`       |                                      | `-c`               | -->