@cyanlabs/t3chat 0.0.1

package/README.md

@@ -0,0 +1,24 @@
+# t3chat-cli
+
+A CLI built with [Crust](https://crustjs.com).
+
+## Development
+
+```sh
+# Run in dev mode
+bun run dev
+
+# Type-check
+bun run check:types
+
+# Build standalone executable
+bun run build
+```
+
+## Usage
+
+```sh
+# Run the CLI
+t3chat-cli world
+t3chat-cli --greet Hey world
+```

package/dist/cli

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Auto-generated by crust build — do not edit
+set -e
+
+source="$0"
+while [ -L "$source" ]; do
+	link_dir="$(cd "$(dirname "$source")" && pwd)"
+	source="$(readlink "$source")"
+	# Resolve relative symlinks
+	[[ "$source" != /* ]] && source="$link_dir/$source"
+done
+dir="$(cd "$(dirname "$source")" && pwd)"
+platform="$(uname -s)-$(uname -m)"
+
+case "$platform" in
+	Linux-x86_64) bin="t3chat-cli-bun-linux-x64-baseline" ;;
+	Linux-aarch64) bin="t3chat-cli-bun-linux-arm64" ;;
+	Darwin-x86_64) bin="t3chat-cli-bun-darwin-x64" ;;
+	Darwin-arm64) bin="t3chat-cli-bun-darwin-arm64" ;;
+	*)
+		echo "[t3chat-cli] Unsupported platform: $platform" >&2
+		echo "[t3chat-cli] Please open an issue with your OS/CPU details." >&2
+		exit 1
+		;;
+esac
+
+bin_path="$dir/$bin"
+
+if [ ! -f "$bin_path" ]; then
+	echo "[t3chat-cli] Prebuilt binary not found: $bin_path" >&2
+	echo "[t3chat-cli] Expected binary for $platform: $bin" >&2
+	echo "[t3chat-cli] Try reinstalling the package." >&2
+	exit 1
+fi
+
+# Ensure the binary is executable
+if [ ! -x "$bin_path" ]; then
+	chmod +x "$bin_path" 2>/dev/null || true
+fi
+
+exec "$bin_path" "$@"

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@cyanlabs/t3chat",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "CLI wrapper for t3.chat",
+  "bin": {
+    "chat": "dist/cli"
+  },
+  "scripts": {
+    "dev": "bun run src/cli.ts",
+    "build": "crust build",
+    "start": "./dist/cli",
+    "check:types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@crustjs/core": "^0.0.6",
+    "@crustjs/plugins": "^0.0.7",
+    "@crustjs/prompts": "^0.0.3"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.29.8",
+    "@crustjs/crust": "^0.0.10",
+    "@types/bun": "latest",
+    "typescript": "^5.9.3"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,56 @@
+import { defineCommand, runMain } from "@crustjs/core";
+import { helpPlugin, renderHelp, versionPlugin } from "@crustjs/plugins";
+import pkg from "../package.json";
+import { auth } from "./commands/auth/index.ts";
+import { models } from "./commands/models.ts";
+import { getCookies, getModel } from "./lib/config.ts";
+import { formatModelName } from "./lib/constants.ts";
+import { sendMessage } from "./lib/t3client.ts";
+
+const main = defineCommand({
+  meta: {
+    name: "chat",
+    description: "CLI wrapper for t3.chat",
+  },
+  args: [
+    {
+      name: "prompt",
+      type: "string",
+      variadic: true,
+      description: "The message to send to t3.chat",
+    },
+  ],
+  subCommands: {
+    auth,
+    models,
+  },
+  async run({ args }) {
+    if (args.prompt.length <= 0) {
+      console.log(renderHelp(main));
+      return;
+    }
+
+    const prompt = args.prompt.join(" ");
+
+    const cookies = getCookies();
+    if (!cookies) {
+      console.error("Not authenticated. Run `chat auth login` first.");
+      process.exit(1);
+    }
+
+    const modelId = getModel();
+    console.log(`Model: ${formatModelName(modelId)}\n`);
+
+    try {
+      await sendMessage(prompt, modelId);
+    } catch (e) {
+      const err = e as Error;
+      console.error(`Error: ${err.message}`);
+      process.exit(1);
+    }
+  },
+});
+
+runMain(main, {
+  plugins: [versionPlugin(pkg.version), helpPlugin()],
+});

package/src/commands/auth/index.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from "@crustjs/core";
+import { login } from "./login.ts";
+
+export const auth = defineCommand({
+  meta: {
+    name: "auth",
+    description: "Manage authentication with t3.chat",
+  },
+  subCommands: {
+    login,
+  },
+});

package/src/commands/auth/login.ts

@@ -0,0 +1,42 @@
+import { defineCommand } from "@crustjs/core";
+import { input } from "@crustjs/prompts";
+import { loadConfig, saveConfig } from "../../lib/config.ts";
+import { T3_CHAT_URL } from "../../lib/constants.ts";
+
+export const login = defineCommand({
+  meta: {
+    name: "login",
+    description: "Authenticate with t3.chat by providing your cookies",
+  },
+  async run() {
+    console.log("Opening t3.chat in your browser...\n");
+
+    // Open browser (macOS)
+    Bun.spawn(["open", T3_CHAT_URL]);
+
+    console.log("To get your cookies:");
+    console.log("  1. Log in to t3.chat in the browser");
+    console.log("  2. Open DevTools (Cmd+Option+I)");
+    console.log("  3. Go to Network tab");
+    console.log("  4. Send any chat message");
+    console.log("  5. Click the /api/chat request");
+    console.log("  6. In the Headers tab, find the 'cookie' request header");
+    console.log("  7. Copy the entire cookie string\n");
+
+    const cookies = await input({
+      message: "Paste your cookie string:",
+      validate: (value) => {
+        if (!value.trim()) return "Cookie string cannot be empty";
+        if (!value.includes("convex-session-id")) {
+          return "Cookie should contain 'convex-session-id'. Make sure you copied the full cookie header.";
+        }
+        return true;
+      },
+    });
+
+    const config = loadConfig();
+    config.cookies = cookies.trim();
+    saveConfig(config);
+    console.log("\nCookies saved. You can now use `chat <prompt>` to chat.");
+  },
+});

package/src/commands/models.ts

@@ -0,0 +1,37 @@
+import { defineCommand } from "@crustjs/core";
+import { filter, spinner } from "@crustjs/prompts";
+import { loadConfig, saveConfig } from "../lib/config.ts";
+import { DEFAULT_MODEL_ID } from "../lib/constants.ts";
+import { fetchModels } from "../lib/t3client.ts";
+
+export const models = defineCommand({
+  meta: {
+    name: "models",
+    description: "Select the default model for chat",
+  },
+  async run() {
+    const config = loadConfig();
+    const currentModel = config.model ?? DEFAULT_MODEL_ID;
+
+    const modelList = await spinner({
+      message: "Fetching available models...",
+      task: () => fetchModels(),
+    });
+
+    console.log(`Current model: ${currentModel}\n`);
+
+    const selected = await filter<string>({
+      message: "Choose a model:",
+      placeholder: "Type to filter...",
+      choices: modelList.map((m) => ({
+        label: `${m.name} (${m.provider}) ${m.cost}`,
+        value: m.id,
+      })),
+    });
+
+    config.model = selected;
+    saveConfig(config);
+    const model = modelList.find((m) => m.id === selected);
+    console.log(`\nDefault model set to: ${model?.name ?? selected}`);
+  },
+});

package/src/lib/config.ts

@@ -0,0 +1,60 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { CONFIG_DIR_NAME, DEFAULT_MODEL_ID } from "./constants.ts";
+
+export interface Config {
+  /** All cookies from t3.chat as a single string (cookie header format) */
+  cookies?: string;
+  /** Selected model ID */
+  model?: string;
+}
+
+function getConfigDir(): string {
+  const dir = join(homedir(), ".config", CONFIG_DIR_NAME);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}
+
+function getConfigPath(): string {
+  return join(getConfigDir(), "config.json");
+}
+
+export function loadConfig(): Config {
+  const path = getConfigPath();
+  if (!existsSync(path)) {
+    return {};
+  }
+  try {
+    const raw = readFileSync(path, "utf-8");
+    return JSON.parse(raw) as Config;
+  } catch {
+    return {};
+  }
+}
+
+export function saveConfig(config: Config): void {
+  const path = getConfigPath();
+  writeFileSync(path, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
+}
+
+export function getCookies(): string | undefined {
+  return loadConfig().cookies;
+}
+
+export function getModel(): string {
+  return loadConfig().model ?? DEFAULT_MODEL_ID;
+}
+
+/**
+ * Extract the convex-session-id value from the stored cookie string.
+ * This is needed in the request body as `convexSessionId`.
+ */
+export function getConvexSessionId(): string | undefined {
+  const cookies = getCookies();
+  if (!cookies) return undefined;
+  const match = cookies.match(/convex-session-id=([^;]+)/);
+  return match?.[1];
+}

package/src/lib/constants.ts

@@ -0,0 +1,44 @@
+export const T3_CHAT_URL = "https://t3.chat";
+export const CHAT_API_URL = "https://t3.chat/api/chat";
+export const TRPC_API_URL = "https://t3.chat/api/trpc";
+// Config paths
+export const CONFIG_DIR_NAME = "t3chat-cli";
+
+export interface Model {
+  id: string;
+  name: string;
+  provider: string;
+  cost: "$" | "$$" | "$$$";
+}
+
+/** Derive provider name from model ID prefix */
+export function getProviderFromModelId(id: string): string {
+  if (id.startsWith("claude-")) return "Anthropic";
+  if (id.startsWith("gpt-") || id.startsWith("o3-")) return "OpenAI";
+  if (id.startsWith("gemini-")) return "Google";
+  if (id.startsWith("deepseek-")) return "DeepSeek";
+  if (id.startsWith("kimi-")) return "Moonshot";
+  if (id.startsWith("llama-")) return "Meta";
+  if (id.startsWith("minimax-")) return "MiniMax";
+  if (id.startsWith("grok-")) return "xAI";
+  if (id.startsWith("glm-")) return "Zhipu";
+  if (id.startsWith("qwen")) return "Alibaba";
+  return "Unknown";
+}
+
+/** Map blended price per 1M tokens to a cost tier */
+export function getCostTier(blendedPrice: number): "$" | "$$" | "$$$" {
+  if (blendedPrice < 1) return "$";
+  if (blendedPrice <= 5) return "$$";
+  return "$$$";
+}
+
+/** Format a model ID into a human-readable name */
+export function formatModelName(id: string): string {
+  return id
+    .split("-")
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+    .join(" ");
+}
+
+export const DEFAULT_MODEL_ID = "kimi-k2.5";

package/src/lib/t3client.ts

@@ -0,0 +1,309 @@
+import { randomUUID } from "node:crypto";
+import {
+  CHAT_API_URL,
+  TRPC_API_URL,
+  T3_CHAT_URL,
+  type Model,
+  getProviderFromModelId,
+  getCostTier,
+  formatModelName,
+} from "./constants.ts";
+import { getCookies, getConvexSessionId, getModel } from "./config.ts";
+
+// ---------------------------------------------------------------------------
+// Shared curl helpers
+// ---------------------------------------------------------------------------
+
+/** Browser-like headers required to bypass Vercel bot protection */
+function browserHeaders(cookies: string): string[] {
+  return [
+    "-H",
+    "Accept: */*",
+    "-H",
+    "Accept-Language: en-US,en;q=0.9",
+    "-H",
+    `Cookie: ${cookies}`,
+    "-H",
+    `Origin: ${T3_CHAT_URL}`,
+    "-H",
+    `Referer: ${T3_CHAT_URL}/`,
+    "-H",
+    "User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36",
+    "-H",
+    'sec-ch-ua: "Not:A-Brand";v="99", "Google Chrome";v="145", "Chromium";v="145"',
+    "-H",
+    "sec-ch-ua-mobile: ?0",
+    "-H",
+    'sec-ch-ua-platform: "macOS"',
+    "-H",
+    "Sec-Fetch-Dest: empty",
+    "-H",
+    "Sec-Fetch-Mode: cors",
+    "-H",
+    "Sec-Fetch-Site: same-origin",
+  ];
+}
+
+/** Run curl and return the response body + HTTP status code */
+async function curlRequest(
+  args: string[],
+): Promise<{ body: string; httpStatus: number }> {
+  const proc = Bun.spawn(
+    [
+      "curl",
+      "--silent",
+      "--show-error",
+      "-w",
+      "\n__HTTP_STATUS__%{http_code}",
+      ...args,
+    ],
+    { stdout: "pipe", stderr: "pipe" },
+  );
+
+  const stdoutText = await new Response(proc.stdout).text();
+  await proc.exited;
+
+  const statusMatch = stdoutText.match(/__HTTP_STATUS__(\d+)$/);
+  const httpStatus = statusMatch ? Number(statusMatch[1]) : 0;
+  const body = statusMatch
+    ? stdoutText.slice(0, statusMatch.index)
+    : stdoutText;
+
+  return { body, httpStatus };
+}
+
+function requireCookies(): string {
+  const cookies = getCookies();
+  if (!cookies) {
+    throw new Error("Not authenticated. Run `chat auth login` first.");
+  }
+  return cookies;
+}
+
+// ---------------------------------------------------------------------------
+// Fetch models via tRPC
+// ---------------------------------------------------------------------------
+
+interface TrpcModelBenchmark {
+  slug: string;
+  intelligenceIndex: number | null;
+  codingIndex: number | null;
+  mathIndex: number | null;
+  pricing: {
+    price_1m_blended_3_to_1: number;
+    price_1m_input_tokens: number;
+    price_1m_output_tokens: number;
+  };
+}
+
+/**
+ * Fetch available models from t3.chat's tRPC endpoint.
+ *
+ * Calls GET /api/trpc/getAllModelBenchmarks which returns a map of
+ * model IDs → benchmark + pricing data. We transform this into our
+ * Model[] format.
+ */
+export async function fetchModels(): Promise<Model[]> {
+  const cookies = requireCookies();
+
+  const input = encodeURIComponent(
+    JSON.stringify({ json: null, meta: { values: ["undefined"] } }),
+  );
+  const url = `${TRPC_API_URL}/getAllModelBenchmarks?input=${input}`;
+
+  const { body, httpStatus } = await curlRequest([
+    url,
+    ...browserHeaders(cookies),
+  ]);
+
+  if (httpStatus !== 200) {
+    throw new Error(`tRPC API returned HTTP ${httpStatus}`);
+  }
+
+  // Parse the tRPC response.
+  // Non-batched format:  { result: { data: { json: { ...models }, meta: { ... } } } }
+  // Batched format:      [{ result: { data: { json: { ...models } } } }]
+  const response = JSON.parse(body);
+
+  let modelMap: Record<string, TrpcModelBenchmark> | undefined;
+
+  if (Array.isArray(response)) {
+    // Batched response — find the first entry with model data
+    for (const item of response) {
+      const candidate = item?.result?.data?.json;
+      if (
+        candidate &&
+        typeof candidate === "object" &&
+        !Array.isArray(candidate)
+      ) {
+        modelMap = candidate;
+        break;
+      }
+    }
+  } else {
+    modelMap = response?.result?.data?.json;
+  }
+
+  if (!modelMap || typeof modelMap !== "object") {
+    throw new Error("Unexpected response format from model benchmarks API");
+  }
+
+  return Object.entries(modelMap)
+    .map(([id, data]) => ({
+      id,
+      name: formatModelName(id),
+      provider: getProviderFromModelId(id),
+      cost: getCostTier(data.pricing.price_1m_blended_3_to_1),
+    }))
+    .sort((a, b) => {
+      if (a.provider !== b.provider)
+        return a.provider.localeCompare(b.provider);
+      return a.id.localeCompare(b.id);
+    });
+}
+
+// ---------------------------------------------------------------------------
+// Chat
+// ---------------------------------------------------------------------------
+
+/**
+ * Build the request body matching t3.chat's expected format.
+ *
+ * The payload was reverse-engineered from the browser's /api/chat request.
+ * All top-level fields appear to be validated server-side.
+ */
+function buildRequestBody(
+  prompt: string,
+  model: string,
+  sessionId: string,
+) {
+  return {
+    messages: [
+      {
+        id: randomUUID(),
+        role: "user",
+        parts: [{ type: "text", text: prompt }],
+        attachments: [],
+      },
+    ],
+    threadMetadata: {
+      id: randomUUID(),
+      title: "",
+    },
+    responseMessageId: randomUUID(),
+    model,
+    convexSessionId: sessionId,
+    modelParams: {
+      reasoningEffort: "low",
+      includeSearch: false,
+      searchLimit: 1,
+    },
+    preferences: {
+      name: "",
+      occupation: "",
+      selectedTraits: [],
+      additionalInfo: "",
+    },
+    userConfiguration: {
+      currentlySelectedModel: model,
+      currentModelParameters: {
+        includeSearch: false,
+        reasoningEffort: "low",
+      },
+      hasMigrated: true,
+      mainFont: "proxima",
+      streamerMode: false,
+      favoriteModels: [],
+      billingEmailsEnabled: true,
+      statsForNerds: false,
+      disableExternalLinkWarning: false,
+      disableHorizontalLines: false,
+    },
+    userInfo: {
+      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+      locale: "en-US",
+    },
+    isEphemeral: true,
+  };
+}
+
+/**
+ * Send a chat message to t3.chat via POST /api/chat using curl.
+ *
+ * We use curl instead of fetch because Vercel's bot protection checks
+ * TLS fingerprints (JA3/JA4). Bun's fetch has a non-browser fingerprint
+ * that gets blocked with a 403. curl's TLS fingerprint is typically allowed.
+ *
+ * The response is SSE (Server-Sent Events) which we parse and stream
+ * text deltas to stdout.
+ */
+export async function sendMessage(
+  prompt: string,
+  model: string,
+): Promise<void> {
+  const cookies = requireCookies();
+
+  const sessionId = getConvexSessionId();
+  if (!sessionId) {
+    throw new Error(
+      "Could not find convex-session-id in your cookies. Run `chat auth login` again.",
+    );
+  }
+
+  const body = buildRequestBody(prompt, model, sessionId);
+
+  const { body: responseBody, httpStatus } = await curlRequest([
+    "-X",
+    "POST",
+    CHAT_API_URL,
+    "-H",
+    "Content-Type: application/json",
+    ...browserHeaders(cookies),
+    "-d",
+    JSON.stringify(body),
+  ]);
+
+  if (httpStatus !== 200) {
+    if (httpStatus === 403 || responseBody.includes("Vercel Security")) {
+      throw new Error(
+        [
+          "Blocked by Vercel's bot protection (403).",
+          "Your cookies may have expired. Try:",
+          "  1. Open t3.chat in Chrome and send a message",
+          "  2. Run `chat auth login` again with fresh cookies",
+          "",
+          "Make sure to copy the FULL cookie header from a recent request.",
+        ].join("\n"),
+      );
+    }
+    throw new Error(`Chat API returned HTTP ${httpStatus}: ${responseBody}`);
+  }
+
+  // Parse SSE lines from the response body
+  const lines = responseBody.split("\n");
+  let hasOutput = false;
+
+  for (const line of lines) {
+    if (!line.startsWith("data: ")) continue;
+    const data = line.slice(6).trim();
+    if (data === "[DONE]") continue;
+
+    try {
+      const event = JSON.parse(data) as {
+        type: string;
+        delta?: string;
+      };
+
+      if (event.type === "text-delta" && event.delta) {
+        process.stdout.write(event.delta);
+        hasOutput = true;
+      }
+    } catch {
+      // Skip non-JSON lines
+    }
+  }
+
+  if (hasOutput) {
+    process.stdout.write("\n");
+  }
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+	"compilerOptions": {
+		"lib": ["ESNext"],
+		"target": "ESNext",
+		"module": "Preserve",
+		"moduleDetection": "force",
+		"moduleResolution": "bundler",
+		"allowImportingTsExtensions": true,
+		"verbatimModuleSyntax": true,
+		"noEmit": true,
+		"strict": true,
+		"skipLibCheck": true,
+		"noFallthroughCasesInSwitch": true,
+		"noUncheckedIndexedAccess": true
+	},
+	"include": ["src"]
+}