cogeai 1.0.0

package/lib/default-config.json

@@ -0,0 +1,422 @@
+{
+  "provider": "gemini",
+  "model": "gemini-2.5-flash",
+  "strategy": "auto",
+  "topModels": [
+    "gemini-2.5-flash",
+    "gemini-2.5-pro",
+    "gpt-4o-mini",
+    "gpt-4.1-mini",
+    "gpt-4o",
+    "gpt-4.1",
+    "mistral-small-latest",
+    "mistral-large-latest",
+    "codestral-latest",
+    "llama-3.3-70b-versatile",
+    "command-a-03-2025",
+    "devstral-small-latest"
+  ],
+  "providers": {
+    "gemini": {
+      "default": "gemini-2.5-flash",
+      "available": [
+        "gemini-2.5-flash",
+        "gemini-2.5-pro",
+        "gemma-3-1b-it",
+        "nano-banana-pro-preview",
+        "gemini-2.0-flash",
+        "gemini-2.0-flash-001",
+        "gemini-2.0-flash-lite-001",
+        "gemini-2.0-flash-lite",
+        "gemma-3-4b-it",
+        "gemma-3-12b-it",
+        "gemma-3-27b-it",
+        "gemma-3n-e4b-it",
+        "gemma-3n-e2b-it",
+        "gemini-flash-latest",
+        "gemini-flash-lite-latest",
+        "gemini-pro-latest",
+        "gemini-2.5-flash-lite",
+        "gemini-2.5-flash-lite-preview-09-2025",
+        "gemini-3-pro-preview",
+        "gemini-3-flash-preview",
+        "gemini-3.1-pro-preview",
+        "gemini-3.1-pro-preview-customtools",
+        "gemini-robotics-er-1.5-preview",
+        "gemini-2.5-computer-use-preview-10-2025",
+        "deep-research-pro-preview-12-2025",
+        "gemini-2.5-flash-preview-tts",
+        "gemini-2.5-pro-preview-tts",
+        "gemini-2.5-flash-image",
+        "gemini-3-pro-image-preview",
+        "gemini-embedding-001",
+        "gemini-2.5-flash-native-audio-latest",
+        "gemini-2.5-flash-native-audio-preview-09-2025",
+        "gemini-2.5-flash-native-audio-preview-12-2025"
+      ]
+    },
+    "openrouter": {
+      "default": "nvidia/nemotron-3-nano-30b-a3b:free",
+      "available": [
+        "nvidia/nemotron-3-nano-30b-a3b:free",
+        "google/gemini-2.5-flash:free",
+        "meta-llama/llama-3.3-70b-instruct:free"
+      ]
+    },
+    "openai": {
+      "default": "gpt-4o-mini",
+      "available": [
+        "gpt-4o-mini",
+        "gpt-4o",
+        "gpt-4.1-mini",
+        "gpt-4.1"
+      ]
+    },
+    "ollama": {
+      "default": "llama3.2",
+      "available": [
+        "llama3.2",
+        "llama3.1",
+        "mistral",
+        "codellama"
+      ]
+    },
+    "cerebras": {
+      "default": "qwen-3-235b-a22b-instruct-2507",
+      "available": [
+        "llama3.1-8b",
+        "gpt-oss-120b",
+        "qwen-3-235b-a22b-instruct-2507",
+        "zai-glm-4.7"
+      ]
+    },
+    "cloudflare": {
+      "default": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
+      "available": [
+        "@cf/google/gemma-2b-it-lora",
+        "@hf/nexusflow/starling-lm-7b-beta",
+        "@cf/meta/llama-3-8b-instruct",
+        "@cf/meta/llama-3.2-3b-instruct",
+        "@hf/thebloke/neural-chat-7b-v3-1-awq",
+        "@cf/meta/llama-guard-3-8b",
+        "@cf/meta/llama-2-7b-chat-fp16",
+        "@cf/mistral/mistral-7b-instruct-v0.1",
+        "@cf/mistral/mistral-7b-instruct-v0.2-lora",
+        "@hf/mistral/mistral-7b-instruct-v0.2",
+        "@cf/fblgit/una-cybertron-7b-v2-bf16",
+        "@cf/thebloke/discolm-german-7b-v1-awq",
+        "@cf/meta/llama-2-7b-chat-int8",
+        "@cf/meta/llama-3.1-8b-instruct-fp8",
+        "@hf/thebloke/mistral-7b-instruct-v0.1-awq",
+        "@cf/qwen/qwen1.5-7b-chat-awq",
+        "@cf/meta/llama-3.2-1b-instruct",
+        "@cf/meta-llama/llama-2-7b-chat-hf-lora",
+        "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
+        "@hf/thebloke/openhermes-2.5-mistral-7b-awq",
+        "@cf/deepseek-ai/deepseek-math-7b-instruct",
+        "@cf/tiiuae/falcon-7b-instruct",
+        "@hf/nousresearch/hermes-2-pro-mistral-7b",
+        "@cf/meta/llama-3.1-8b-instruct-awq",
+        "@hf/thebloke/zephyr-7b-beta-awq",
+        "@cf/google/gemma-7b-it-lora",
+        "@cf/mistralai/mistral-small-3.1-24b-instruct",
+        "@cf/meta/llama-3-8b-instruct-awq",
+        "@cf/defog/sqlcoder-7b-2",
+        "@hf/google/gemma-7b-it",
+        "@cf/openai/gpt-oss-120b",
+        "@cf/qwen/qwen1.5-0.5b-chat",
+        "@cf/tinyllama/tinyllama-1.1b-chat-v1.0",
+        "@cf/deepseek-ai/deepseek-r1-distill-qwen-32b",
+        "@cf/zai-org/glm-4.7-flash",
+        "@hf/thebloke/llama-2-13b-chat-awq",
+        "@hf/thebloke/deepseek-coder-6.7b-base-awq",
+        "@cf/ibm-granite/granite-4.0-h-micro",
+        "@hf/thebloke/deepseek-coder-6.7b-instruct-awq",
+        "@cf/qwen/qwen2.5-coder-32b-instruct",
+        "@cf/aisingapore/gemma-sea-lion-v4-27b-it",
+        "@cf/qwen/qwen3-30b-a3b-fp8",
+        "@cf/qwen/qwen1.5-1.8b-chat",
+        "@cf/microsoft/phi-2",
+        "@cf/openai/gpt-oss-20b",
+        "@cf/qwen/qwen1.5-14b-chat-awq",
+        "@cf/openchat/openchat-3.5-0106",
+        "@cf/meta/llama-4-scout-17b-16e-instruct",
+        "@cf/google/gemma-3-12b-it",
+        "@cf/qwen/qwq-32b",
+        "@cf/meta/llama-3.2-11b-vision-instruct"
+      ]
+    },
+    "cohere": {
+      "default": "command-a-03-2025",
+      "available": [
+        "command-a-03-2025",
+        "command-r-plus",
+        "command-r"
+      ]
+    },
+    "github-models": {
+      "default": "openai/gpt-4o-mini",
+      "blacklist": [
+        "openai/gpt-5-mini"
+      ],
+      "available": [
+        "openai/gpt-4.1-mini",
+        "openai/gpt-4.1-nano",
+        "openai/gpt-5-mini",
+        "openai/gpt-5-nano",
+        "openai/o1-mini",
+        "openai/o3-mini",
+        "openai/o4-mini",
+        "meta/meta-llama-3.1-8b-instruct",
+        "mistral-ai/ministral-3b",
+        "mistral-ai/mistral-small-2503",
+        "xai/grok-3-mini",
+        "microsoft/phi-4-mini-instruct",
+        "microsoft/phi-4-mini-reasoning",
+        "openai/gpt-4o-mini",
+        "openai/gpt-4.1",
+        "openai/gpt-5",
+        "openai/gpt-5-chat",
+        "openai/o1",
+        "openai/o1-preview",
+        "openai/o3",
+        "ai21-labs/ai21-jamba-1.5-large",
+        "cohere/cohere-command-a",
+        "cohere/cohere-command-r-08-2024",
+        "cohere/cohere-command-r-plus-08-2024",
+        "deepseek/deepseek-r1",
+        "deepseek/deepseek-r1-0528",
+        "deepseek/deepseek-v3-0324",
+        "meta/llama-3.3-70b-instruct",
+        "meta/llama-4-scout-17b-16e-instruct",
+        "meta/meta-llama-3.1-405b-instruct",
+        "mistral-ai/codestral-2501",
+        "xai/grok-3",
+        "microsoft/mai-ds-r1",
+        "microsoft/phi-4",
+        "microsoft/phi-4-reasoning",
+        "openai/gpt-4o",
+        "meta/llama-4-maverick-17b-128e-instruct-fp8",
+        "mistral-ai/mistral-medium-2505",
+        "microsoft/phi-4-multimodal-instruct",
+        "openai/text-embedding-3-large",
+        "openai/text-embedding-3-small",
+        "meta/llama-3.2-11b-vision-instruct",
+        "meta/llama-3.2-90b-vision-instruct"
+      ]
+    },
+    "groq": {
+      "default": "llama-3.3-70b-versatile",
+      "available": [
+        "llama-3.3-70b-versatile",
+        "llama-3.1-8b-instant",
+        "mixtral-8x7b-32768"
+      ]
+    },
+    "huggingface": {
+      "default": "meta-llama/Llama-3.1-8B-Instruct",
+      "available": [
+        "meta-llama/Llama-3.1-8B-Instruct",
+        "Qwen/Qwen3-8B",
+        "Qwen/Qwen2.5-7B-Instruct",
+        "Qwen/Qwen2.5-Coder-7B-Instruct",
+        "Qwen/Qwen3-VL-8B-Instruct",
+        "meta-llama/Llama-3.2-3B-Instruct",
+        "meta-llama/Meta-Llama-3-8B-Instruct",
+        "mistralai/Mistral-7B-Instruct-v0.2",
+        "meta-llama/Llama-3.2-1B-Instruct",
+        "nvidia/NVIDIA-Nemotron-Nano-9B-v2",
+        "Qwen/Qwen2.5-VL-7B-Instruct",
+        "allenai/Molmo2-8B",
+        "HuggingFaceTB/SmolLM3-3B",
+        "swiss-ai/Apertus-8B-Instruct-2509",
+        "allenai/Olmo-3-7B-Think",
+        "deepseek-ai/DeepSeek-R1-Distill-Qwen-7B",
+        "marin-community/marin-8b-instruct",
+        "NousResearch/Hermes-2-Pro-Llama-3-8B",
+        "Sao10K/L3-8B-Stheno-v3.2",
+        "allenai/Olmo-3-7B-Instruct",
+        "arcee-ai/Trinity-Mini",
+        "Sao10K/L3-8B-Lunaris-v1",
+        "Qwen/Qwen2.5-Coder-3B-Instruct",
+        "deepseek-ai/DeepSeek-R1-Distill-Llama-8B",
+        "Qwen/Qwen3.5-397B-A17B",
+        "zai-org/GLM-5",
+        "MiniMaxAI/MiniMax-M2.5",
+        "moonshotai/Kimi-K2.5",
+        "Qwen/Qwen3-Coder-Next",
+        "zai-org/GLM-4.7-Flash",
+        "openai/gpt-oss-120b",
+        "openai/gpt-oss-20b",
+        "deepseek-ai/DeepSeek-V3.2",
+        "google/gemma-3-27b-it",
+        "Qwen/Qwen3-4B-Instruct-2507",
+        "deepseek-ai/DeepSeek-R1",
+        "deepseek-ai/DeepSeek-V3.2-Exp",
+        "Qwen/Qwen3-Coder-Next-FP8",
+        "meta-llama/Llama-3.3-70B-Instruct",
+        "zai-org/GLM-4.7",
+        "Qwen/Qwen3-4B-Thinking-2507",
+        "moonshotai/Kimi-K2-Thinking",
+        "XiaomiMiMo/MiMo-V2-Flash",
+        "google/gemma-3n-E4B-it",
+        "Qwen/Qwen3-Next-80B-A3B-Instruct",
+        "deepseek-ai/DeepSeek-R1-Distill-Qwen-32B",
+        "Qwen/Qwen3-32B",
+        "Qwen/Qwen3-VL-30B-A3B-Instruct",
+        "Qwen/Qwen3-14B",
+        "Qwen/Qwen3-Coder-30B-A3B-Instruct",
+        "moonshotai/Kimi-K2-Instruct",
+        "MiniMaxAI/MiniMax-M2.1",
+        "meta-llama/Llama-3.1-70B-Instruct",
+        "moonshotai/Kimi-K2-Instruct-0905",
+        "Qwen/Qwen3-VL-32B-Instruct",
+        "CohereLabs/command-a-reasoning-08-2025",
+        "ServiceNow-AI/Apriel-1.6-15b-Thinker",
+        "Qwen/Qwen3-VL-235B-A22B-Thinking",
+        "meta-llama/Llama-4-Scout-17B-16E-Instruct",
+        "Qwen/Qwen2.5-Coder-32B-Instruct",
+        "Qwen/Qwen3-30B-A3B",
+        "openai/gpt-oss-safeguard-20b",
+        "Qwen/Qwen3-VL-30B-A3B-Thinking",
+        "Qwen/QwQ-32B",
+        "MiniMaxAI/MiniMax-M2",
+        "zai-org/GLM-4.6V-Flash",
+        "Qwen/Qwen2.5-VL-72B-Instruct",
+        "zai-org/AutoGLM-Phone-9B-Multilingual",
+        "meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8",
+        "Qwen/Qwen3-Next-80B-A3B-Thinking",
+        "zai-org/GLM-4.6V",
+        "deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B",
+        "deepseek-ai/DeepSeek-Prover-V2-671B",
+        "meta-llama/Llama-4-Maverick-17B-128E-Instruct",
+        "Qwen/Qwen3-235B-A22B-Instruct-2507",
+        "deepseek-ai/DeepSeek-V3.1-Terminus",
+        "deepseek-ai/DeepSeek-R1-0528",
+        "allenai/Olmo-3.1-32B-Think",
+        "CohereLabs/c4ai-command-r7b-12-2024",
+        "Qwen/Qwen3-235B-A22B-Thinking-2507",
+        "zai-org/GLM-4.5V",
+        "deepseek-ai/DeepSeek-V3",
+        "utter-project/EuroLLM-22B-Instruct-2512",
+        "CohereLabs/c4ai-command-a-03-2025",
+        "Qwen/Qwen3-VL-235B-A22B-Instruct",
+        "zai-org/GLM-4.5-Air-FP8",
+        "allenai/Olmo-3.1-32B-Instruct",
+        "CohereLabs/command-a-translate-08-2025",
+        "EssentialAI/rnj-1-instruct",
+        "meta-llama/Llama-Guard-4-12B",
+        "meta-llama/Meta-Llama-3-70B-Instruct",
+        "deepseek-ai/DeepSeek-V3.1",
+        "Qwen/Qwen2.5-72B-Instruct",
+        "zai-org/GLM-4-32B-0414",
+        "MiniMaxAI/MiniMax-M1-80k",
+        "aisingapore/Gemma-SEA-LION-v4-27B-IT",
+        "zai-org/GLM-4.5V-FP8",
+        "alpindale/WizardLM-2-8x22B",
+        "zai-org/GLM-4.5",
+        "swiss-ai/Apertus-70B-Instruct-2509",
+        "zai-org/GLM-4.6V-FP8",
+        "Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8",
+        "zai-org/GLM-4.5-Air",
+        "aisingapore/Qwen-SEA-LION-v4-32B-IT",
+        "zai-org/GLM-4.6",
+        "zai-org/GLM-4.6-FP8",
+        "deepcogito/cogito-671b-v2.1-FP8",
+        "Sao10K/L3-70B-Euryale-v2.1",
+        "zai-org/GLM-4.7-FP8",
+        "dicta-il/DictaLM-3.0-24B-Thinking",
+        "baidu/ERNIE-4.5-VL-424B-A47B-Base-PT",
+        "Qwen/Qwen3-Coder-480B-A35B-Instruct",
+        "deepcogito/cogito-671b-v2.1",
+        "baidu/ERNIE-4.5-300B-A47B-Base-PT",
+        "baidu/ERNIE-4.5-VL-28B-A3B-PT",
+        "Qwen/Qwen2.5-VL-32B-Instruct",
+        "baidu/ERNIE-4.5-21B-A3B-PT",
+        "tokyotech-llm/Llama-3.3-Swallow-70B-Instruct-v0.4",
+        "deepseek-ai/DeepSeek-V3-0324",
+        "CohereLabs/c4ai-command-r-08-2024",
+        "deepseek-ai/DeepSeek-R1-Distill-Llama-70B",
+        "Qwen/Qwen3-235B-A22B",
+        "katanemo/Arch-Router-1.5B",
+        "CohereLabs/aya-expanse-32b",
+        "CohereLabs/c4ai-command-r7b-arabic-02-2025",
+        "CohereLabs/aya-vision-32b",
+        "CohereLabs/command-a-vision-07-2025"
+      ]
+    },
+    "codestral": {
+      "default": "codestral-latest",
+      "available": [
+        "codestral-latest"
+      ]
+    },
+    "mistral": {
+      "default": "mistral-small-latest",
+      "available": [
+        "codestral-latest",
+        "devstral-small-latest",
+        "mistral-small-latest",
+        "mistral-large-latest",
+        "mistral-tiny-2407",
+        "mistral-tiny-latest",
+        "devstral-small-2507",
+        "labs-devstral-small-2512",
+        "mistral-small-2506",
+        "labs-mistral-small-creative",
+        "magistral-small-2509",
+        "magistral-small-latest",
+        "voxtral-mini-2507",
+        "voxtral-mini-latest",
+        "voxtral-small-2507",
+        "voxtral-small-latest",
+        "ministral-3b-2512",
+        "ministral-3b-latest",
+        "ministral-8b-2512",
+        "ministral-8b-latest",
+        "mistral-small-2501",
+        "voxtral-mini-2602",
+        "mistral-medium-2505",
+        "mistral-medium-2508",
+        "mistral-medium-latest",
+        "mistral-medium",
+        "mistral-vibe-cli-with-tools",
+        "open-mistral-nemo",
+        "open-mistral-nemo-2407",
+        "mistral-large-2411",
+        "pixtral-large-2411",
+        "pixtral-large-latest",
+        "mistral-large-pixtral-2411",
+        "codestral-2508",
+        "devstral-medium-2507",
+        "devstral-2512",
+        "mistral-vibe-cli-latest",
+        "devstral-medium-latest",
+        "devstral-latest",
+        "magistral-medium-2509",
+        "magistral-medium-latest",
+        "mistral-large-2512",
+        "ministral-14b-2512",
+        "ministral-14b-latest",
+        "mistral-embed-2312",
+        "mistral-embed",
+        "codestral-embed",
+        "codestral-embed-2505",
+        "mistral-moderation-2411",
+        "mistral-moderation-latest",
+        "mistral-ocr-2512",
+        "mistral-ocr-latest",
+        "mistral-ocr-2505",
+        "mistral-ocr-2503",
+        "voxtral-mini-transcribe-2507"
+      ]
+    },
+    "vercel-ai": {
+      "default": "gpt-4o-mini",
+      "available": [
+        "gpt-4o-mini",
+        "gpt-4o"
+      ]
+    }
+  }
+}

package/lib/init-config.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { writeDefaultConfigIfMissing, getConfigPath } from "./config.js";
+
+try {
+  const created = writeDefaultConfigIfMissing();
+  if (created) {
+    console.log("coge: created default config at", getConfigPath());
+  }
+} catch (err) {
+  console.error("coge: failed to init config:", err.message);
+  process.exit(1);
+}

package/lib/model-classify.js

@@ -0,0 +1,70 @@
+import { createRequire } from "module";
+
+const require = createRequire(import.meta.url);
+const defaultConfig = require("./default-config.json");
+
+const IRRELEVANT_PATTERNS = /whisper|tts|dall-e|embed|moderation|audio|image|vision|realtime|transcri|ocr/i;
+const SMALL_PATTERNS = /\bmini\b|\bsmall\b|\bnano\b|\btiny\b|\bfast\b|\binstant\b|[_-]8b\b|[_-]7b\b|[_-]3b\b|[_-]1b\b|[_-]2b\b/i;
+
+const TOP_MODELS = new Set(defaultConfig.topModels ?? []);
+
+/**
+ * Classifies a model as "top", "small", "large", or "irrelevant".
+ * Top models are checked first (hardcoded list), then API metadata, then name heuristics.
+ * @param {string} id  Model ID
+ * @param {{ type?: string; description?: string }} [metadata]
+ * @returns {"top" | "small" | "large" | "irrelevant"}
+ */
+export function classifyModel(id, metadata) {
+  // Top models — hardcoded curated list
+  if (TOP_MODELS.has(id)) return "top";
+
+  // Check metadata
+  if (metadata?.type) {
+    const t = metadata.type.toLowerCase();
+    if (t.includes("audio") || t.includes("image") || t.includes("embed") || t.includes("tts")) {
+      return "irrelevant";
+    }
+  }
+  if (metadata?.description) {
+    if (IRRELEVANT_PATTERNS.test(metadata.description)) return "irrelevant";
+  }
+
+  // Name heuristics
+  if (IRRELEVANT_PATTERNS.test(id)) return "irrelevant";
+  if (SMALL_PATTERNS.test(id)) return "small";
+  return "large";
+}
+
+/**
+ * Normalizes an available entry to { id, category } object.
+ * Handles both plain strings (backward compat) and objects.
+ * @param {string | { id: string; category?: string }} entry
+ * @returns {{ id: string; category: string }}
+ */
+export function normalizeAvailableEntry(entry) {
+  if (typeof entry === "string") return { id: entry, category: classifyModel(entry) };
+  return { id: entry.id, category: entry.category ?? classifyModel(entry.id) };
+}
+
+/**
+ * Checks whether a model ID is in the provider's blacklist.
+ * @param {string} modelId
+ * @param {string[]} [blacklist]
+ * @returns {boolean}
+ */
+export function isBlacklisted(modelId, blacklist) {
+  return Array.isArray(blacklist) && blacklist.includes(modelId);
+}
+
+const CATEGORY_ORDER = { top: 0, small: 1, large: 2, irrelevant: 3, blacklist: 4 };
+
+/**
+ * Sorts an array of { id, category } entries by category order: top → small → large → irrelevant.
+ * Mutates and returns the array.
+ * @param {{ id: string; category: string }[]} entries
+ * @returns {{ id: string; category: string }[]}
+ */
+export function sortByCategory(entries) {
+  return entries.sort((a, b) => (CATEGORY_ORDER[a.category] ?? 2) - (CATEGORY_ORDER[b.category] ?? 2));
+}

package/lib/stats.js

@@ -0,0 +1,83 @@
+import fs from "fs";
+import path from "path";
+import { getConfigDir } from "./config.js";
+
+const STATS_FILENAME = "stats.json";
+
+/**
+ * Returns path to stats.json in the config directory.
+ * @returns {string}
+ */
+function getStatsPath() {
+  return path.join(getConfigDir(), STATS_FILENAME);
+}
+
+/**
+ * Loads usage stats from stats.json. Returns {} if file missing.
+ * @returns {Record<string, {execute: number, copy: number, cancel: number, last_used: string}>}
+ */
+export function loadStats() {
+  try {
+    const raw = fs.readFileSync(getStatsPath(), "utf8");
+    return JSON.parse(raw);
+  } catch (err) {
+    if (err.code === "ENOENT") return {};
+    throw err;
+  }
+}
+
+/**
+ * Saves usage stats to stats.json.
+ * @param {Record<string, {execute: number, copy: number, cancel: number, last_used: string}>} stats
+ */
+export function saveStats(stats) {
+  const dir = getConfigDir();
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(getStatsPath(), JSON.stringify(stats, null, 2) + "\n", "utf8");
+}
+
+/**
+ * Records a user action (execute/copy/cancel) for a provider:model arm.
+ * @param {string} armKey - e.g. "gemini:gemini-2.5-flash"
+ * @param {"execute"|"copy"|"cancel"} action
+ */
+export function recordAction(armKey, action) {
+  const stats = loadStats();
+  if (!stats[armKey]) {
+    stats[armKey] = { execute: 0, copy: 0, cancel: 0 };
+  }
+  stats[armKey][action] += 1;
+  stats[armKey].last_used = new Date().toISOString();
+  saveStats(stats);
+}
+
+/**
+ * Formats stats as a table string for --stats output.
+ * @param {Record<string, {execute: number, copy: number, cancel: number}>} stats
+ * @returns {string}
+ */
+export function formatStats(stats) {
+  const keys = Object.keys(stats);
+  if (keys.length === 0) {
+    return "No usage stats recorded yet.";
+  }
+
+  const header = "Provider/Model                      Exec  Copy  Cancel  Total  Accept%";
+  const separator = "-".repeat(header.length);
+  const lines = [header, separator];
+
+  for (const key of keys) {
+    const s = stats[key];
+    const total = s.execute + s.copy + s.cancel;
+    const acceptPct = total > 0 ? Math.round(((s.execute + s.copy) / total) * 100) : 0;
+    const line = key.padEnd(36)
+      + String(s.execute).padStart(4) + "  "
+      + String(s.copy).padStart(4) + "  "
+      + String(s.cancel).padStart(6) + "  "
+      + String(total).padStart(5) + "  "
+      + String(acceptPct).padStart(6) + "%";
+    lines.push(line);
+  }
+
+  return lines.join("\n");
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "cogeai",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "AI-powered command generator — describe what you want, get a shell command back",
+  "main": "coge.js",
+  "bin": {
+    "coge": "coge.js"
+  },
+  "files": [
+    "coge.js",
+    "providers/",
+    "lib/",
+    "bin/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "sync-models": "node bin/sync-models.js",
+    "postinstall": "node lib/init-config.js"
+  },
+  "keywords": [
+    "cli",
+    "ai",
+    "llm",
+    "command-generator",
+    "shell"
+  ],
+  "author": "",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vovanmozg/coge.git"
+  },
+  "dependencies": {
+    "@google/genai": "^1.7.0",
+    "clipboardy": "^4.0.0"
+  }
+}

package/providers/cerebras.js

@@ -0,0 +1,11 @@
+import { makeOpenAICompatible, fetchOpenAIModelIds } from "./openai-compatible.js";
+
+export async function fetchModels() {
+  return fetchOpenAIModelIds("https://api.cerebras.ai/v1/models", process.env.COGE_CEREBRAS_API_KEY);
+}
+
+export const createCerebrasProvider = makeOpenAICompatible(
+  "cerebras",
+  "https://api.cerebras.ai/v1/chat/completions",
+  "COGE_CEREBRAS_API_KEY",
+);

package/providers/cloudflare.js

@@ -0,0 +1,41 @@
+import { createOpenAICompatibleProvider } from "./openai-compatible.js";
+
+export async function fetchModels() {
+  const accountId = process.env.COGE_CLOUDFLARE_ACCOUNT_ID;
+  const apiKey = process.env.COGE_CLOUDFLARE_API_KEY;
+  if (!apiKey) throw new Error("COGE_CLOUDFLARE_API_KEY not set.");
+  if (!accountId) throw new Error("COGE_CLOUDFLARE_ACCOUNT_ID not set.");
+
+  const { classifyModel } = await import("../lib/model-classify.js");
+  const url = `https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/models/search?task=Text Generation&per_page=200`;
+  const res = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
+  if (!res.ok) throw new Error(`Cloudflare API ${res.status}: ${res.statusText}`);
+  const data = await res.json();
+  if (!data.success) throw new Error("Cloudflare API error: " + JSON.stringify(data.errors));
+  return data.result.map((m) => ({ id: m.name, category: classifyModel(m.name) }));
+}
+
+/**
+ * @param {string} apiKey
+ * @param {string} [model]
+ * @returns {import("./index.js").Provider}
+ */
+export function createCloudflareProvider(apiKey, model) {
+  const accountId = process.env.COGE_CLOUDFLARE_ACCOUNT_ID;
+  if (!apiKey) {
+    throw new Error("COGE_CLOUDFLARE_API_KEY not set.");
+  }
+  if (!accountId) {
+    throw new Error("COGE_CLOUDFLARE_ACCOUNT_ID not set.");
+  }
+
+  const url = `https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/v1/chat/completions`;
+  const provider = createOpenAICompatibleProvider({
+    name: "cloudflare",
+    url,
+    envKey: "COGE_CLOUDFLARE_API_KEY",
+    apiKey,
+  });
+  provider._model = model;
+  return provider;
+}