tweakcc-fixed 2.0.9 → 2.0.11

package/README.md

@@ -3,13 +3,13 @@
 A hard fork of [Piebald-AI/tweakcc](https://github.com/Piebald-AI/tweakcc) that patches an installed Claude Code in place — both npm `cli.js` and the JavaScript embedded in a native Bun binary — to apply **curated system-prompt overrides** and a set of **fork-only patches**. It is purpose-built to pair with [skrabe/lobotomized-claude-code](https://github.com/skrabe/lobotomized-claude-code), and it stays current with every Claude Code release through its own prompt-extraction pipeline.
 
 > [!IMPORTANT]
-> **This fork is a superset of upstream and no longer merges from it (2026-06-04).** Upstream's `tweakcc` gates system-prompt overrides **off** for native installs and doesn't have this fork's override mechanisms (inline-blob, system-reminders) or extended extractor; we add those and apply system prompts to native installs too. Upstream is essentially static — recent releases are version bumps plus prompt-data drops we supersede (our extractor names 990 prompts for CC 2.1.179 under our own per-model override conventions (capturing every model-facing string below the old 500-char floor), including 546 ids absent from Piebald's published extract) — so there's nothing to gain by merging. We keep the `upstream` remote only as a **fetch-only comparison signal** and extract our own prompts.
+> **This fork is a superset of upstream and no longer merges from it (2026-06-04).** Upstream's `tweakcc` gates system-prompt overrides **off** for native installs and doesn't have this fork's override mechanisms (inline-blob, system-reminders) or extended extractor; we add those and apply system prompts to native installs too. Upstream is essentially static — recent releases are version bumps plus prompt-data drops we supersede (our extractor names 1018 prompts for CC 2.1.185 under our own per-model override conventions (capturing every model-facing string below the old 500-char floor), including 565 ids absent from Piebald's published extract) — so there's nothing to gain by merging. We keep the `upstream` remote only as a **fetch-only comparison signal** and extract our own prompts.
 
 |                        |                                                                                                           |
 | ---------------------- | --------------------------------------------------------------------------------------------------------- |
 | **This fork**          | [skrabe/tweakcc-fixed](https://github.com/skrabe/tweakcc-fixed)                                           |
 | **Base**               | [Piebald-AI/tweakcc](https://github.com/Piebald-AI/tweakcc) @ `bc41a43`, then diverged                    |
-| **Target CC versions** | 2.0.98 through **2.1.181**                                                                                |
+| **Target CC versions** | 2.0.98 through **2.1.185**                                                                                |
 | **Install**            | `npx tweakcc-fixed@latest` — published on npm from this repo ([Install](#install))                        |
 | **Pairs with**         | [skrabe/lobotomized-claude-code](https://github.com/skrabe/lobotomized-claude-code) (per-model overrides) |
 | **Agent guide**        | [`AGENTS.md`](./AGENTS.md) — bug-class diagnostics, patch authoring, the version-bump pipeline            |
@@ -26,7 +26,7 @@ A directory `~/.tweakcc/system-reminders/` with one `.md` file per editable dyna
 - **Custom body** → pristine content replaced.
 - **`{{placeholder}}` tokens** → whitelisted JS expressions substituted at apply time.
 
-Files are seeded automatically on first `--apply`. The registry (~30 entries) covers the claudeMd context wrapper, the anti-thinking nudge, MCP per-server overrides, token/budget telemetry, plan-mode reminders, hook/tool-call wrappers, the task-list reminder, the ultrathink booster, the user-sent-new-message wrap, the stop-hook session-goal, and more. UI: `tweakcc` → **System reminders (injection lobotomy)**.
+Files are seeded automatically on first `--apply`. The registry (35 entries) covers the claudeMd context wrapper, the anti-thinking nudge, MCP per-server overrides, token/budget telemetry, plan-mode reminders, hook/tool-call wrappers, the task-list reminder, the ultrathink booster, the user-sent-new-message wrap, the stop-hook session-goal, and more. UI: `tweakcc` → **System reminders (injection lobotomy)**.
 
 ### MCP per-server instruction routing
 
@@ -69,11 +69,11 @@ Fork-only patch work: scoping #664's backslash-doubling to quote contexts only (
 
 These come from the tweakcc base and work unchanged in this fork: system-prompt customization, custom themes, thinking-verb and spinner customization, toolsets (`/toolset`), input-pattern highlighters, `opusplan[1m]`, MCP startup optimization, table-format options, token-count rounding, statusline throttling, `AGENTS.md`/`CLAUDE.md` alternate names, session naming (`/title`, `/rename`), subagent model selection, and the `unpack` / `repack` CLI commands.
 
-For detailed docs on these shared features, see the [upstream tweakcc README](https://github.com/Piebald-AI/tweakcc#readme) — with the caveat that upstream is now v4 and has diverged, so its API / `adhoc-patch` / remote-config sections and native-install behavior describe upstream's build, not this fork.
+For detailed docs on these shared features, see the [upstream tweakcc README](https://github.com/Piebald-AI/tweakcc#readme) — with the caveat that upstream is now v4 and has diverged, so its `adhoc-patch` / remote-config sections and native-install behavior describe upstream's build, not this fork. For this fork's programmatic surface, see [Library API](#library-api) below rather than upstream's API docs.
 
 ## Pairing with lobotomized-claude-code
 
-Use this fork's extraction surface with [skrabe/lobotomized-claude-code](https://github.com/skrabe/lobotomized-claude-code) — per-model override sets (**Claude Opus 4.8**, Claude Fable 5) tuned against this fork's extraction. Our named-prompt JSON catches prompts Piebald's published extract doesn't (546 ids for CC 2.1.179 absent from their extract), and the system-reminder + `string`-kind reach lets the overrides cover content the base mechanisms can't.
+Use this fork's extraction surface with [skrabe/lobotomized-claude-code](https://github.com/skrabe/lobotomized-claude-code) — per-model override sets (**Claude Opus 4.8**, Claude Fable 5) tuned against this fork's extraction. Our named-prompt JSON catches prompts Piebald's published extract doesn't (565 ids for CC 2.1.185 absent from their extract), and the system-reminder + `string`-kind reach lets the overrides cover content the base mechanisms can't.
 
 ## Install
 
@@ -107,6 +107,47 @@ node dist/index.mjs --apply
 
 tweakcc-fixed patches Claude Code's minified `cli.js`, reading customizations from `~/.tweakcc/config.json`. For npm installs `cli.js` is patched directly; for native installs the JS is extracted from the Bun binary with [node-lief](https://github.com/Piebald-AI/node-lief), patched, and repacked (with stale Bun bytecode cleared). Updating Claude Code overwrites the patches, but they live in your config, so reapply with `--apply`. Revert with `--restore`.
 
+## Library API
+
+Besides the CLI, `tweakcc-fixed` is published as a library — the building blocks
+the tool uses, exposed for writing your own Claude Code patching scripts. Every
+export is documented inline (JSDoc, shipped in the `.d.ts`).
+
+```ts
+import {
+  tryDetectInstallation,
+  readContent,
+  writeContent,
+  backupFile,
+  helpers,
+} from 'tweakcc-fixed';
+
+// Find Claude Code (npm or native Bun install)
+const installation = await tryDetectInstallation();
+
+// Back up before touching anything
+await backupFile(installation.path, './cli.js.bak');
+
+// Read the JS (extracted from the native binary when needed)
+const { content, clearBytecode } = await readContent(installation);
+
+// Patch it — `helpers` finds minified identifiers in the bundle
+const reactVar = helpers.getReactVar(content);
+const patched = content.replace(/…/, '…');
+
+// Write it back. For native installs this repacks the binary; `clearBytecode`
+// MUST be threaded through from readContent so a stale Bun bytecode cache
+// doesn't keep running the old code.
+await writeContent(installation, patched, clearBytecode);
+```
+
+Main exports: `findAllInstallations` / `tryDetectInstallation` /
+`showInteractiveInstallationPicker` (detection), `readContent` / `writeContent`
+(JS I/O across npm + native), `backupFile` / `restoreBackup`, `readTweakccConfig`
+plus the config-path helpers, the `helpers` toolkit (minified-identifier finders
++ diff utilities), and the `Installation` / `TweakccConfig` / `Settings` /
+`DetectInstallationOptions` types.
+
 ## The `showtime` skill (CC version-bump pipeline)
 
 When Claude Code ships a new version, [`skills/showtime/`](./skills/showtime/) is a [Claude Code skill](https://docs.claude.com/en/docs/claude-code/skills) that drives the whole bump end-to-end on your local machine — extract the new `cli.js`, run the prompt extractor, drive the version-bump report to zero, realign drifted overrides, and prove it landed clean against a **four-zeros** bar (smoke + apply-hygiene + no-orphan-overrides + no-latent-var-breakage). It ships three files: