@cortex-context/cli 0.0.18 → 0.0.20

package/README.md

@@ -68,23 +68,58 @@ cortex-context doctor
 
 ## Commands
 
-| Command                         | Description                                      |
-| ------------------------------- | ------------------------------------------------ |
-| `cortex-context init`           | Full interactive setup                           |
-| `cortex-context sync`           | Update Skills + MCP to latest bundled version    |
-| `cortex-context sync --dry-run` | Preview sync changes                             |
-| `cortex-context doctor`         | Validate installation + test Cortex connectivity |
+### Workspace setup
+
+| Command                           | Description                                            |
+| --------------------------------- | ------------------------------------------------------ |
+| `cortex-context init`             | Full interactive setup (Skills, MCP, hooks, rules)     |
+| `cortex-context update`           | Update Skills + MCP files to latest bundled version    |
+| `cortex-context update --dry-run` | Preview update changes without writing files           |
+| `cortex-context sync`             | Ingest latest git diff into the Cortex Knowledge Graph |
+| `cortex-context sync --dry-run`   | Show diff without sending to Cortex API                |
+| `cortex-context doctor`           | Validate installation + test Cortex connectivity       |
+| `cortex-context uninstall`        | Remove Cortex Context from the workspace               |
+
+### Local server
+
+| Command                                  | Description                                                             |
+| ---------------------------------------- | ----------------------------------------------------------------------- |
+| `cortex-context server`                  | Install Docker (if needed) and start Neo4j + Cortex API locally         |
+| `cortex-context server --embeddings`     | Start with embeddings image (sentence-transformers, CPU, ~1.5 GB)       |
+| `cortex-context server --embeddings-gpu` | Start with embeddings GPU image (PyTorch CUDA, ~2 GB — requires nvidia) |
+| `cortex-context upgrade`                 | Pull latest Cortex backend image and restart the local stack            |
+| `cortex-context upgrade --embeddings`    | Upgrade using the embeddings image variant                              |
+| `cortex-context upgrade --pull-only`     | Pull latest image without recreating the container                      |
+
+### Token management
+
+| Command                            | Description                                             |
+| ---------------------------------- | ------------------------------------------------------- |
+| `cortex-context token`             | Show current API token (masked)                         |
+| `cortex-context token --show`      | Reveal the full token                                   |
+| `cortex-context token --rotate`    | Generate a new random token, save it, and restart stack |
+| `cortex-context token --set <val>` | Set a specific token value (empty string clears auth)   |
+
+### Advanced
+
+| Command                    | Description                                                         |
+| -------------------------- | ------------------------------------------------------------------- |
+| `cortex-context reset`     | Wipe all nodes and relationships from the Knowledge Graph           |
+| `cortex-context mcp-serve` | Start the MCP server over stdio (used internally by VS Code/Cursor) |
 
 ## Options (init)
 
-| Flag            | Description                          |
-| --------------- | ------------------------------------ |
-| `--url <url>`   | Cortex server URL (skips prompt)     |
-| `--token <tok>` | API token (skips prompt)             |
-| `--workspace`   | Target workspace path (default: cwd) |
-| `--skip-mcp`    | Don't install MCP server             |
-| `--skip-skills` | Don't install Skills                 |
-| `--force`       | Overwrite existing files             |
+| Flag            | Description                                                               |
+| --------------- | ------------------------------------------------------------------------- |
+| `--url <url>`   | Cortex server URL (skips prompt)                                          |
+| `--token <tok>` | API token (skips prompt)                                                  |
+| `--workspace`   | Target workspace path (default: cwd)                                      |
+| `--local`       | Deploy a local Cortex stack with Docker (mutually exclusive with `--url`) |
+| `--skip-mcp`    | Don't configure MCP server                                                |
+| `--skip-skills` | Don't install Skills                                                      |
+| `--skip-hooks`  | Don't install git hooks                                                   |
+| `--skip-rules`  | Don't inject Copilot/Cursor rules                                         |
+| `--force`       | Overwrite existing files without prompting                                |
 
 ## Contributing
 

package/dist/index.js

@@ -28421,13 +28421,21 @@ async function serverCommand(options) {
         `       cortex-context init --url ${CORTEX_URL2} --token ${serverToken}`
       )
     );
+    console.log(source_default.dim("  2. Check connectivity:"));
+    console.log(source_default.cyan("       cortex-context doctor"));
+    console.log("");
+    console.log(source_default.dim("  To rotate the token later:"));
+    console.log(source_default.cyan("       cortex-context token --rotate"));
   } else {
     console.log(source_default.bold("  Next steps:"));
     console.log(source_default.dim("  1. Initialize your workspace:"));
     console.log(source_default.cyan(`       cortex-context init --url ${CORTEX_URL2}`));
+    console.log(source_default.dim("  2. Check connectivity:"));
+    console.log(source_default.cyan("       cortex-context doctor"));
+    console.log("");
+    console.log(source_default.dim("  To add a token later:"));
+    console.log(source_default.cyan("       cortex-context token --rotate"));
   }
-  console.log(source_default.dim("  2. Check connectivity:"));
-  console.log(source_default.cyan("       cortex-context doctor"));
   console.log("");
   console.log(source_default.dim("  To stop the stack:"));
   console.log(source_default.dim("    docker compose -f docker-compose.local.yml down"));
@@ -28777,6 +28785,18 @@ async function tokenCommand(options) {
     console.log(
       source_default.green(newToken ? "  \u2713 Token updated" : "  \u2713 Token cleared")
     );
+    if (newToken) {
+      const config3 = readConfig();
+      console.log("");
+      console.log(
+        source_default.dim("  Re-initialize your workspace to update MCP config:")
+      );
+      console.log(
+        source_default.cyan(
+          `    cortex-context init --url ${config3.url ?? "http://localhost:8082"} --token ${newToken}`
+        )
+      );
+    }
     console.log("");
     await applyTokenRestart();
     console.log("");
@@ -28877,7 +28897,7 @@ async function upgradeCommand(options) {
     console.log("");
     process.exit(1);
   }
-  const imageTag = options.embeddings ? "latest-embeddings" : "latest";
+  const imageTag = options.embeddingsGpu ? "latest-embeddings-gpu" : options.embeddings ? "latest-embeddings" : "latest";
   const cortexImage = `ghcr.io/rodrigoroldan/cortex-context:${imageTag}`;
   console.log(source_default.dim(`  Target image: ${cortexImage}`));
   console.log(source_default.dim(`  Compose dir:  ${workDir}`));
@@ -28912,7 +28932,8 @@ async function upgradeCommand(options) {
     return;
   }
   const result = await upgradeLocalStack(workDir, {
-    embeddings: options.embeddings
+    embeddings: options.embeddings,
+    gpu: options.embeddingsGpu
   });
   if (!result.upgraded) {
     console.error(source_default.red(`  \u2717 Upgrade failed: ${result.error}`));
@@ -29014,6 +29035,9 @@ function createCli() {
     "--dir <path>",
     "Directory with docker-compose.local.yml (defaults to ~/.cortex-context)"
   ).option("--embeddings", "Use the embeddings-enabled image variant").option(
+    "--embeddings-gpu",
+    "Use the embeddings GPU image variant (PyTorch CUDA, ~2 GB \u2014 requires nvidia)"
+  ).option(
     "--pull-only",
     "Pull the latest image without recreating the container"
   ).action(upgradeCommand);