@cheapcode/cli 0.20.3

package/LICENSE

@@ -0,0 +1,29 @@
+NOTICE
+
+This repository contains code derived from Anthropic's Claude Code CLI.
+
+The original Claude Code source is proprietary software:
+  Copyright (c) Anthropic PBC. All rights reserved.
+  Subject to Anthropic's Commercial Terms of Service.
+
+Modifications and additions by OpenClaude contributors are offered under
+the MIT License where legally permissible:
+
+  MIT License
+  Copyright (c) 2026 OpenClaude contributors (modifications only)
+
+  Permission is hereby granted, free of charge, to any person obtaining
+  a copy of the modifications made by OpenClaude contributors, to deal
+  in those modifications without restriction, including without limitation
+  the rights to use, copy, modify, merge, publish, distribute, sublicense,
+  and/or sell copies, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included
+  in all copies or substantial portions of the modifications.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.
+
+The underlying derived code remains subject to Anthropic's copyright.
+This project does not have Anthropic's authorization to distribute
+their proprietary source. Users and contributors should evaluate their
+own legal position.

package/README.md

@@ -0,0 +1,156 @@
+# Cheap Code
+
+Cheap Code is the coding-agent terminal for CheapVibeCode.
+
+## Install
+
+Requires Node.js 22 or newer.
+
+```bash
+npm install -g @cheapcode/cli
+cheapcode
+```
+
+Run once without a global installation:
+
+```bash
+npx --yes @cheapcode/cli
+```
+
+Public Windows PowerShell install:
+
+```powershell
+$env:CVC_API_KEY='sk-cvc-...'; iex(irm 'https://cheapvibecode.ru/cheapcode-windows')
+```
+
+Public Linux/macOS install:
+
+```bash
+bash <(curl -fsSL 'https://cheapvibecode.ru/cheapcode') 'sk-cvc-...'
+```
+
+The public installer downloads the packaged CLI archive and installs the
+`cheapcode` command globally with npm. Release
+archives are selected through the CheapVibeCode update manifest and verified
+with their published SHA-256 digest before installation.
+
+For local development from the repository root on Windows PowerShell:
+
+```powershell
+.\scripts\install-cheapcode-cli.ps1
+```
+
+On Linux/macOS:
+
+```bash
+bash scripts/install-cheapcode-cli.sh
+```
+
+The installer checks Node.js, installs Bun if needed, installs dependencies,
+builds `dist/cli.mjs`, and links these commands globally:
+
+- `cheapcode`
+
+To build the downloadable archive served by the website:
+
+```powershell
+.\scripts\package-cheapcode-cli.ps1
+```
+
+## Run
+
+```bash
+cheapcode
+```
+
+Useful maintenance commands:
+
+```bash
+cheapcode --help
+cheapcode --version
+cheapcode update
+```
+
+Long sessions default to an 8 GB Node.js old-space limit. Override it with
+either supported launcher form:
+
+```bash
+cheapcode --max-memory=4096
+cheapcode --max-memory 4096
+```
+
+For provider variables stored in a local env file:
+
+```bash
+cheapcode --provider-env-file .env
+```
+
+The launcher stores Cheap Code-specific CLI state in
+`~/.cheapcode-cli` by default. Override it with
+`CHEAPCODE_CLI_CONFIG_DIR` if needed.
+
+## Token and context efficiency
+
+Cheap Code defers MCP tool schemas until the model actually needs them,
+compresses old tool results, preserves prompt-cache prefixes, and batches
+automatic memory extraction. The default memory extractor runs once per five
+eligible user turns instead of spawning a background agent after every turn.
+
+Use `/config` to change **Background memory extraction**:
+
+- `every 5 turns` (default) — balanced persistence and cost
+- `every 10 turns` — cheaper for high-volume sessions
+- `every turn` — maximum memory freshness, highest token use
+- `off` — disables automatic extraction but keeps explicit memory reads and
+  writes available
+
+For one session, the environment variable takes precedence over settings:
+
+```bash
+CHEAPCODE_MEMORY_EXTRACTION_INTERVAL=10 cheapcode
+CHEAPCODE_MEMORY_EXTRACTION_INTERVAL=off cheapcode
+```
+
+Two curated MCP integrations ship as enabled built-in plugins. Disable either
+from `/plugin` if it is unnecessary for a project:
+
+- `context7-docs@builtin` — current, version-specific library documentation.
+  It uses Context7's remote OAuth endpoint; do not include confidential code in
+  documentation queries.
+- `serena-code-intelligence@builtin` — symbol-level navigation and editing for
+  large repositories. It requires `uvx`; the plugin pins Serena rather than
+  executing a moving Git branch and disables the automatic web dashboard.
+
+Useful diagnostics:
+
+```text
+/context       # what currently occupies the context window
+/ctx           # compact context visualization
+/cache-stats   # prompt-cache reads, writes, and hit ratio
+/doctor        # oversized memory, agent, and MCP warnings
+```
+
+Avoid enabling multiple code-indexing MCPs at once. Pick one semantic/symbolic
+retriever and compare it against the built-in search on your real workload.
+Third-party hooks that intercept Bash or rewrite tool output should remain
+experimental until their interaction with tool-history compression and context
+collapse has been measured.
+
+## Develop
+
+```bash
+cd cli
+bun install --frozen-lockfile
+bun run build
+node bin/cheapcode --version
+```
+
+Run the complete release gate before packaging:
+
+```bash
+bun run check
+```
+
+It covers type checking, generated integration drift, release-manifest
+consistency, a production smoke build, the privacy guard, dead-code analysis,
+and the full test suite.

package/bin/cheapcode

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+
+/**
+ * Cheap Code -- coding-agent terminal for CheapVibeCode
+ *
+ * When dist/cli.mjs exists (built), run that.
+ * Otherwise, tell the user to build first or use `bun run dev`.
+ */
+
+import { existsSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath, pathToFileURL } from 'url'
+import { spawnSync } from 'child_process'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const distPath = join(__dirname, '..', 'dist', 'cli.mjs')
+
+const HEAP_RELAUNCHED_ENV = 'CHEAPCODE_HEAP_RELAUNCHED'
+const DISABLE_HEAP_RELAUNCH_ENV = 'CHEAPCODE_DISABLE_HEAP_RELAUNCH'
+const HEAP_SIZE_ENV = 'CHEAPCODE_NODE_MAX_OLD_SPACE_SIZE_MB'
+const DEFAULT_HEAP_SIZE_MB = 8192
+const CONFIG_DIR_ENV = 'CHEAPCODE_CLI_CONFIG_DIR'
+
+if (!process.env.CHEAPCODE_CONFIG_DIR) {
+  process.env.CHEAPCODE_CONFIG_DIR =
+    process.env[CONFIG_DIR_ENV] ||
+    join(process.env.USERPROFILE || process.env.HOME || '.', '.cheapcode-cli')
+}
+
+function hasNodeFlag(args, flag) {
+  return args.some(arg => arg === flag || arg.startsWith(`${flag}=`))
+}
+
+function hasNodeOptionFlag(flag) {
+  return hasNodeFlag([
+    ...process.execArgv,
+    ...(process.env.NODE_OPTIONS || '').split(/\s+/).filter(Boolean),
+  ], flag)
+}
+
+function parsePositiveMemoryMb(rawValue) {
+  if (!/^[1-9]\d*$/.test(rawValue)) return undefined
+
+  const parsed = Number(rawValue)
+  return Number.isSafeInteger(parsed) ? parsed : undefined
+}
+
+function parseLauncherArgs(args) {
+  const childArgs = []
+  let maxMemoryMb
+  let sawMaxMemory = false
+  let parsingOptions = true
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index]
+
+    if (arg === '--') {
+      parsingOptions = false
+      childArgs.push(arg)
+      continue
+    }
+
+    if (parsingOptions && (arg === '--max-memory' || arg.startsWith('--max-memory='))) {
+      if (sawMaxMemory) {
+        return {
+          error: '--max-memory may only be specified once',
+        }
+      }
+      sawMaxMemory = true
+
+      let rawValue
+      if (arg === '--max-memory') {
+        const nextArg = args[index + 1]
+        if (nextArg === undefined || nextArg === '--' || nextArg.startsWith('--')) {
+          return {
+            error: '--max-memory requires a positive integer value in MB',
+          }
+        }
+        rawValue = nextArg
+        index += 1
+      } else {
+        rawValue = arg.slice('--max-memory='.length)
+        if (!rawValue) {
+          return {
+            error: '--max-memory requires a positive integer value in MB',
+          }
+        }
+      }
+
+      maxMemoryMb = parsePositiveMemoryMb(rawValue)
+      if (maxMemoryMb === undefined) {
+        return {
+          error: `--max-memory must be a positive integer in MB; received ${JSON.stringify(rawValue)}`,
+        }
+      }
+      continue
+    }
+
+    childArgs.push(arg)
+  }
+
+  return { childArgs, maxMemoryMb }
+}
+
+const parsedLauncherArgs = parseLauncherArgs(process.argv.slice(2))
+if (parsedLauncherArgs.error) {
+  console.error(`cheapcode: ${parsedLauncherArgs.error}`)
+  process.exit(2)
+}
+
+process.argv = [
+  process.argv[0],
+  process.argv[1],
+  ...parsedLauncherArgs.childArgs,
+]
+
+if (parsedLauncherArgs.maxMemoryMb !== undefined) {
+  const value = String(parsedLauncherArgs.maxMemoryMb)
+  process.env[HEAP_SIZE_ENV] = value
+  process.env.CHEAPCODE_MAX_MEMORY_MB = value
+}
+
+function getHeapSizeMb() {
+  const raw = process.env[HEAP_SIZE_ENV]
+  if (!raw) return DEFAULT_HEAP_SIZE_MB
+  const parsed = Number.parseInt(raw, 10)
+  return Number.isSafeInteger(parsed) && parsed > 0
+    ? parsed
+    : DEFAULT_HEAP_SIZE_MB
+}
+
+function relaunchWithLongSessionHeapIfNeeded() {
+  if (process.env[DISABLE_HEAP_RELAUNCH_ENV] === '1') return
+  if (process.env[HEAP_RELAUNCHED_ENV] === '1') return
+  const hasHeapLimit = hasNodeOptionFlag('--max-old-space-size')
+  const hasExplicitGc = hasNodeOptionFlag('--expose-gc')
+  const hasLauncherHeapOverride = parsedLauncherArgs.maxMemoryMb !== undefined
+  if (hasHeapLimit && hasExplicitGc && !hasLauncherHeapOverride) return
+
+  const execArgv = [...process.execArgv]
+  if (!hasHeapLimit || hasLauncherHeapOverride) {
+    execArgv.push(`--max-old-space-size=${getHeapSizeMb()}`)
+  }
+
+  // Expose explicit GC for long interactive sessions. NODE_OPTIONS cannot
+  // carry --expose-gc, so the executable wrapper must add it before startup.
+  if (!hasExplicitGc) {
+    execArgv.push('--expose-gc')
+  }
+
+  // Preserve the original argv[1] (which may be a symlink like
+  // /usr/local/bin/cheapcode) instead of resolving it via import.meta.url.
+  // Resolving symlinks here defeats install-type detection downstream: a real
+  // npm global install (symlink → node_modules/@cheapcode/cli/bin) would
+  // resolve to the package's real path inside node_modules, which is fine, but
+  // a `npm install -g .` dev symlink resolves back to the repo and looks like
+  // a source-tree dev run. Using argv[1] keeps the invocation path stable so
+  // doctorDiagnostic's npm-global path markers can match correctly.
+  const launcherPath = process.argv[1] || fileURLToPath(import.meta.url)
+
+  const result = spawnSync(process.execPath, [
+    ...execArgv,
+    launcherPath,
+    ...process.argv.slice(2),
+  ], {
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      [HEAP_RELAUNCHED_ENV]: '1',
+    },
+  })
+
+  if (result.error) {
+    console.error(`cheapcode: failed to restart with long-session heap: ${result.error.message}`)
+    process.exit(1)
+  }
+
+  process.exit(result.status ?? 1)
+}
+
+if (existsSync(distPath)) {
+  relaunchWithLongSessionHeapIfNeeded()
+  await import(pathToFileURL(distPath).href)
+} else {
+  console.error(`
+  cheapcode: dist/cli.mjs not found.
+
+  Build first:
+    bun run build
+
+  Or run directly with Bun:
+    bun run dev
+
+  See README.md for setup instructions.
+`)
+  process.exit(1)
+}