cctrans 0.1.0 → 0.2.0

package/bin/{tt.js → cctrans.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 'use strict';
-// tt — control + test CLI for the Claude Code bilingual (EN->ZH) overlay.
+// cctrans — control + test CLI for the Claude Code bilingual overlay.
 //
-//   tt on | off | toggle | status
-//   tt backend <openai|google>
-//   tt install | uninstall        register/remove the MessageDisplay hook
-//   tt last [N]                    translate the latest (or Nth-back) reply -> stdout
-//   tt test <text...>              translate ad-hoc text -> stdout
-//   tt help
+//   cctrans on | off | toggle | status
+//   cctrans backend <openai|google>
+//   cctrans install | uninstall        register/remove the MessageDisplay hook
+//   cctrans last [N]                    translate the latest (or Nth-back) reply -> stdout
+//   cctrans test <text...>              translate ad-hoc text -> stdout
+//   cctrans help
 
 const fs = require('fs');
 const os = require('os');
@@ -36,8 +36,8 @@ function readSettings() {
   try { return JSON.parse(fs.readFileSync(SETTINGS, 'utf8')); } catch (e) { return {}; }
 }
 function writeSettings(s) {
-  try { fs.copyFileSync(SETTINGS, SETTINGS + '.bak-tt'); } catch (e) {}
-  const tmp = SETTINGS + '.tt.tmp';
+  try { fs.copyFileSync(SETTINGS, SETTINGS + '.bak-cctrans'); } catch (e) {}
+  const tmp = SETTINGS + '.cctrans.tmp';
   fs.writeFileSync(tmp, JSON.stringify(s, null, 2));
   fs.renameSync(tmp, SETTINGS);
 }
@@ -62,7 +62,7 @@ function install() {
     changed = true;
   }
   if (!inputHookInstalled(s)) {
-    // Registered always; the hook exits instantly unless `tt input on`.
+    // Registered always; the hook exits instantly unless `cctrans input on`.
     s.hooks.UserPromptSubmit = s.hooks.UserPromptSubmit || [];
     s.hooks.UserPromptSubmit.push({ hooks: [{ type: 'command', command: 'node ' + INPUT_HOOK_PATH }] });
     changed = true;
@@ -73,23 +73,23 @@ function install() {
   } else {
     console.log(C.green('✓') + ' hooks already registered in ' + SETTINGS);
   }
-  // Make `tt` runnable from anywhere (best-effort symlink on a common PATH dir).
+  // Make `cctrans` runnable from anywhere (best-effort symlink on a common PATH dir).
   const linkDir = path.join(os.homedir(), '.local', 'bin');
-  const link = path.join(linkDir, 'tt');
+  const link = path.join(linkDir, 'cctrans');
   try {
     fs.mkdirSync(linkDir, { recursive: true });
     try { fs.unlinkSync(link); } catch (e) {}
-    fs.symlinkSync(path.resolve(__dirname, 'tt.js'), link);
-    fs.chmodSync(path.resolve(__dirname, 'tt.js'), 0o755);
-    console.log(C.green('✓') + ' linked `tt` -> ' + link + (process.env.PATH.includes(linkDir) ? '' : C.dim('  (add ' + linkDir + ' to PATH)')));
+    fs.symlinkSync(path.resolve(__dirname, 'cctrans.js'), link);
+    fs.chmodSync(path.resolve(__dirname, 'cctrans.js'), 0o755);
+    console.log(C.green('✓') + ' linked `cctrans` -> ' + link + (process.env.PATH.includes(linkDir) ? '' : C.dim('  (add ' + linkDir + ' to PATH)')));
   } catch (e) {
-    console.log(C.dim('  (could not symlink tt; add alias:  alias tt=\'node ' + path.resolve(__dirname, 'tt.js') + '\')'));
+    console.log(C.dim('  (could not symlink cctrans; add alias:  alias cctrans=\'node ' + path.resolve(__dirname, 'cctrans.js') + '\')'));
   }
   console.log('');
   console.log('Next:');
   console.log('  1. Restart Claude Code (new session) so the hook loads.');
   console.log('  2. Send any message — replies now show ' + C.bold('English + 中文') + ' inline.');
-  console.log('  3. Toggle anytime:  ' + C.bold('!tt off') + ' / ' + C.bold('!tt on') + '  (typed inside Claude Code).');
+  console.log('  3. Toggle anytime:  ' + C.bold('!cctrans off') + ' / ' + C.bold('!cctrans on') + '  (typed inside Claude Code).');
 }
 
 function uninstall() {
@@ -114,11 +114,11 @@ function status() {
   const lang = getLang(st.target);
   console.log(C.bold('cctranslate status'));
   console.log('  enabled : ' + (st.enabled ? C.green('ON') : C.red('OFF')));
-  console.log('  hook    : ' + (installed ? C.green('installed') : C.red('not installed') + C.dim('  (run: tt install)')));
+  console.log('  hook    : ' + (installed ? C.green('installed') : C.red('not installed') + C.dim('  (run: cctrans install)')));
   console.log('  backend : ' + st.backend + (b ? (b.available() ? C.green('  (ready)') : C.red('  (missing: ' + b.needs + ')')) : C.red('  (unknown backend)')));
-  console.log('  lang    : ' + st.target + (lang ? C.dim('  (' + lang.name + ')') : C.red('  (unsupported — see: tt lang)')));
-  console.log('  input   : ' + (st.inputEn ? C.green('ON') : 'off') + C.dim('  (prompt -> English; toggle: tt input on|off)'));
-  console.log('  keys    : ' + Object.keys(keys.readKeys()).length + ' in ' + keys.KEYS_FILE + C.dim('  (manage: tt key)'));
+  console.log('  lang    : ' + st.target + (lang ? C.dim('  (' + lang.name + ')') : C.red('  (unsupported — see: cctrans lang)')));
+  console.log('  input   : ' + (st.inputEn ? C.green('ON') : 'off') + C.dim('  (prompt -> English; toggle: cctrans input on|off)'));
+  console.log('  keys    : ' + Object.keys(keys.readKeys()).length + ' in ' + keys.KEYS_FILE + C.dim('  (manage: cctrans key)'));
   console.log('  state   : ' + STATE_FILE);
 }
 
@@ -141,7 +141,7 @@ function keyCmd(rest) {
 
 function backends() {
   const st = getState();
-  console.log(C.bold('backends') + C.dim('  (switch: tt backend <id>)'));
+  console.log(C.bold('backends') + C.dim('  (switch: cctrans backend <id>)'));
   for (const b of listBackends()) {
     const mark = b.id === st.backend ? C.cyan('▶ ') : '  ';
     const ok = b.available() ? C.green('ready    ') : C.red('missing  ');
@@ -175,29 +175,29 @@ async function last(nBack) {
 }
 
 function help() {
-  console.log(`${C.bold('tt')} — cctranslate: bilingual overlay for Claude Code
+  console.log(`${C.bold('cctrans')} — bilingual overlay for Claude Code
 
 ${C.bold('Control')}
-  tt on | off | toggle      turn the inline translation on/off
-  tt input on | off         translate non-English input to English (as context)
-  tt status                 show current state
-  tt lang [code]            show/set target language (zh-Hans, zh-Hant, ja, ko, ru, hi)
-  tt backend <id>           choose translation engine
-  tt backends               list engines + availability
+  cctrans on | off | toggle      turn the inline translation on/off
+  cctrans input on | off         translate non-English input to English (as context)
+  cctrans status                 show current state
+  cctrans lang [code]            show/set target language (zh-Hans, zh-Hant, ja, ko, ru, hi)
+  cctrans backend <id>           choose translation engine
+  cctrans backends               list engines + availability
 
 ${C.bold('Setup')}
-  tt install                register hooks (+ link tt), then run setup
-  tt setup                  interactive wizard: language, backend, API keys
+  cctrans install                register hooks (+ link cctrans), then run setup
+  cctrans setup                  interactive wizard: language, backend, API keys
                             (flags: --lang --backend --key --yes)
-  tt key [id] [value]       manage API keys in ~/.cc-translate/keys.json
+  cctrans key [id] [value]       manage API keys in ~/.cc-translate/keys.json
                             (ids: openai, anthropic, deepl, azure, azure-region)
-  tt uninstall              remove the hooks
+  cctrans uninstall              remove the hooks
 
 ${C.bold('Manual / test')}
-  tt last [N]               translate the latest (or N-back) assistant reply
-  tt test <text...>         translate ad-hoc English text
+  cctrans last [N]               translate the latest (or N-back) assistant reply
+  cctrans test <text...>         translate ad-hoc English text
 
-${C.dim('Tip: toggle from inside Claude Code by typing  !tt off  /  !tt on')}`);
+${C.dim('Tip: toggle from inside Claude Code by typing  !cctrans off  /  !cctrans on')}`);
 }
 
 async function main() {
@@ -210,7 +210,7 @@ async function main() {
       const id = rest[0];
       const b = id && getBackend(id);
       if (!b) {
-        console.error('usage: tt backend <' + listBackends().map((x) => x.id).join('|') + '>');
+        console.error('usage: cctrans backend <' + listBackends().map((x) => x.id).join('|') + '>');
         process.exit(1);
       }
       setState({ backend: id });
@@ -253,7 +253,7 @@ async function main() {
       else if (sub === 'toggle') setState({ inputEn: !getState().inputEn });
       const st = getState();
       console.log('input translation (prompt -> English): ' + (st.inputEn ? C.green('ON') : C.red('OFF')) +
-        (inputHookInstalled() ? '' : C.red('  (hook not installed — run: tt install)')));
+        (inputHookInstalled() ? '' : C.red('  (hook not installed — run: cctrans install)')));
       break;
     }
     case 'uninstall': uninstall(); break;
@@ -261,7 +261,7 @@ async function main() {
     case 'last': await last(parseInt(rest[0], 10) || 0); break;
     case 'test': {
       const text = rest.join(' ');
-      if (!text) { console.error('usage: tt test <text>'); process.exit(1); }
+      if (!text) { console.error('usage: cctrans test <text>'); process.exit(1); }
       await renderText(text); break;
     }
     case 'help': case '--help': case '-h': case undefined: help(); break;

package/hook/message-display.js

@@ -42,8 +42,8 @@ function saveFence(id, index, inFence, final) {
 let data = '';
 process.stdin.on('data', (d) => (data += d));
 process.stdin.on('end', async () => {
-  if (process.env.TT_DEBUG_STDIN) {
-    try { fs.appendFileSync(process.env.TT_DEBUG_STDIN, '\n===== delta =====\n' + data + '\n'); } catch (e) {}
+  if (process.env.CCTRANS_DEBUG_STDIN) {
+    try { fs.appendFileSync(process.env.CCTRANS_DEBUG_STDIN, '\n===== delta =====\n' + data + '\n'); } catch (e) {}
   }
   let inp = {};
   try { inp = JSON.parse(data); } catch (e) { return showOriginal(); }
@@ -52,8 +52,8 @@ process.stdin.on('end', async () => {
   if (!delta) return showOriginal();
 
   // Recursion guard: the claude-code backend spawns `claude -p` with
-  // TT_DISABLE=1 so a child Claude process can never re-enter this hook.
-  if (process.env.TT_DISABLE) return showOriginal();
+  // CCTRANS_DISABLE=1 so a child Claude process can never re-enter this hook.
+  if (process.env.CCTRANS_DISABLE) return showOriginal();
 
   let st;
   try { st = getState(); } catch (e) { return showOriginal(); }

package/hook/user-prompt-submit.js

@@ -23,10 +23,10 @@ function passThrough() { process.exit(0); }
 let data = '';
 process.stdin.on('data', (d) => (data += d));
 process.stdin.on('end', async () => {
-  if (process.env.TT_DEBUG_STDIN) {
-    try { require('fs').appendFileSync(process.env.TT_DEBUG_STDIN, '\n===== prompt =====\n' + data + '\n'); } catch (e) {}
+  if (process.env.CCTRANS_DEBUG_STDIN) {
+    try { require('fs').appendFileSync(process.env.CCTRANS_DEBUG_STDIN, '\n===== prompt =====\n' + data + '\n'); } catch (e) {}
   }
-  if (process.env.TT_DISABLE) return passThrough();
+  if (process.env.CCTRANS_DISABLE) return passThrough();
 
   let inp = {};
   try { inp = JSON.parse(data); } catch (e) { return passThrough(); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cctrans",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Bilingual inline translation overlay for Claude Code: a translated line (zh/ja/ko/ru/hi) under each English line, right in the conversation — non-destructive, zero main-loop tokens.",
   "license": "MIT",
   "author": "Roy Jiang",
@@ -24,7 +24,7 @@
     "korean"
   ],
   "bin": {
-    "tt": "bin/tt.js"
+    "cctrans": "bin/cctrans.js"
   },
   "files": [
     "bin/",
@@ -32,7 +32,8 @@
     "src/",
     "README*.md",
     "ROADMAP.md",
-    "LICENSE"
+    "LICENSE",
+    "MOTIVATION.md"
   ],
   "engines": {
     "node": ">=18"

package/src/backends/anthropic.js

@@ -16,7 +16,7 @@ const SCHEMA = {
 module.exports = {
   id: 'anthropic',
   kind: 'llm',
-  needs: 'anthropic key (tt key anthropic <value>)',
+  needs: 'anthropic key (cctrans key anthropic <value>)',
   available() { return !!getKey('anthropic'); },
   async translate(lines, langCode, opts) {
     opts = opts || {};

package/src/backends/azure.js

@@ -8,7 +8,7 @@ const { getKey } = require('../keys');
 module.exports = {
   id: 'azure',
   kind: 'mt',
-  needs: 'azure key (tt key azure <value>; region: tt key azure-region <value>)',
+  needs: 'azure key (cctrans key azure <value>; region: cctrans key azure-region <value>)',
   available() { return !!getKey('azure'); },
   async translate(lines, langCode) {
     const key = getKey('azure');

package/src/backends/claude-code.js

@@ -3,7 +3,7 @@
 // on the user's Claude subscription (no separate API key). Measured ~3s per
 // call (CLI startup) — usable within the hook's 10s budget but noticeably
 // slower than HTTP backends; offered as the no-key option, not the default.
-// TT_DISABLE=1 is set on the child as a recursion guard (the hook exits early
+// CCTRANS_DISABLE=1 is set on the child as a recursion guard (the hook exits early
 // when it sees it), and --settings {} -style hook loading is avoided by -p
 // print mode having no display path.
 const { execFile } = require('child_process');
@@ -16,7 +16,7 @@ function runClaude(prompt, timeoutMs) {
       ['-p', '--model', 'claude-haiku-4-5', '--output-format', 'text'],
       {
         timeout: timeoutMs,
-        env: Object.assign({}, process.env, { TT_DISABLE: '1' }),
+        env: Object.assign({}, process.env, { CCTRANS_DISABLE: '1' }),
         maxBuffer: 1024 * 1024,
       },
       (err, stdout) => (err ? reject(err) : resolve(stdout)),
@@ -29,7 +29,7 @@ module.exports = {
   id: 'claude-code',
   kind: 'cli',
   needs: 'claude CLI logged in (uses your subscription; ~3s/call)',
-  available() { return !process.env.TT_DISABLE; },
+  available() { return !process.env.CCTRANS_DISABLE; },
   async translate(lines, langCode, opts) {
     opts = opts || {};
     const lang = getLang(langCode);

package/src/backends/deepl.js

@@ -8,7 +8,7 @@ const { getKey } = require('../keys');
 module.exports = {
   id: 'deepl',
   kind: 'mt',
-  needs: 'deepl key (tt key deepl <value>)',
+  needs: 'deepl key (cctrans key deepl <value>)',
   available() { return !!getKey('deepl'); },
   async translate(lines, langCode) {
     const key = getKey('deepl');

package/src/backends/index.js

@@ -2,7 +2,7 @@
 // Backend registry. Each backend implements:
 //   id        - string
 //   kind      - 'llm' | 'mt' | 'cli'  (informational)
-//   needs     - human-readable requirement shown by `tt backends`
+//   needs     - human-readable requirement shown by `cctrans backends`
 //   available() -> boolean            (are its prerequisites present?)
 //   translate(lines, langCode, opts) -> Promise<string[]>  (same length/order)
 

package/src/backends/openai.js

@@ -6,7 +6,7 @@ const { getKey } = require('../keys');
 module.exports = {
   id: 'openai',
   kind: 'llm',
-  needs: 'openai key (tt key openai <value>)',
+  needs: 'openai key (cctrans key openai <value>)',
   available() { return !!getKey('openai'); },
   async translate(lines, langCode, opts) {
     opts = opts || {};

package/src/config.js

@@ -1,9 +1,9 @@
 'use strict';
 // Persistent settings for the translator. Everything user-configurable lives
 // in files under ~/.cc-translate/ — never in shell environment variables:
-//   state.json  — settings (this module); edit by hand or via tt commands
+//   state.json  — settings (this module); edit by hand or via cctrans commands
 //   keys.json   — API secrets (src/keys.js); chmod 600
-// TT_HOME (test plumbing) and TT_DISABLE/TT_DEBUG_STDIN (hook internals) are
+// CCTRANS_HOME (test plumbing) and CCTRANS_DISABLE/CCTRANS_DEBUG_STDIN (hook internals) are
 // the only env vars the tool reads.
 
 const fs = require('fs');
@@ -11,7 +11,7 @@ const os = require('os');
 const path = require('path');
 
 const HOME = os.homedir();
-const BASE = process.env.TT_HOME || path.join(HOME, '.cc-translate');
+const BASE = process.env.CCTRANS_HOME || path.join(HOME, '.cc-translate');
 const STATE_FILE = path.join(BASE, 'state.json');
 const CACHE_DIR = path.join(BASE, 'cache');
 

package/src/keys.js

@@ -1,17 +1,17 @@
 'use strict';
 // API-key store. Keys come from exactly ONE place: ~/.cc-translate/keys.json
-// (chmod 600), written by `tt setup` / `tt key` or edited by hand. Shell
+// (chmod 600), written by `cctrans setup` / `cctrans key` or edited by hand. Shell
 // environment variables are never consulted — this tool's keys and the
 // terminal's keys cannot contaminate each other.
 //
 // NOTE: keys.js must not require config.js (config.js requires us for the
-// default-backend decision). TT_HOME is internal plumbing for tests only.
+// default-backend decision). CCTRANS_HOME is internal plumbing for tests only.
 
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
 
-const BASE = process.env.TT_HOME || path.join(os.homedir(), '.cc-translate');
+const BASE = process.env.CCTRANS_HOME || path.join(os.homedir(), '.cc-translate');
 const KEYS_FILE = path.join(BASE, 'keys.json');
 
 const KEY_IDS = ['openai', 'anthropic', 'deepl', 'azure', 'azure-region'];

package/src/setup.js

@@ -1,6 +1,6 @@
 'use strict';
 // Interactive setup wizard: language -> backend -> API-key entry -> live
-// verification -> save. Re-runnable via `tt setup`; non-interactive with
+// verification -> save. Re-runnable via `cctrans setup`; non-interactive with
 // flags (--lang, --backend, --key, --yes). Keys go to keys.json only — the
 // shell environment is never read.
 
@@ -32,7 +32,7 @@ async function runSetup(opts) {
   };
 
   try {
-    console.log(C.bold('cctranslate setup') + C.dim('  (re-run anytime: tt setup)'));
+    console.log(C.bold('cctranslate setup') + C.dim('  (re-run anytime: cctrans setup)'));
 
     // 1. Target language
     let lang = opts.lang;
@@ -89,7 +89,7 @@ async function runSetup(opts) {
       console.log(C.red('verification failed: ' + e.message));
     }
 
-    console.log(C.dim('\nNext: restart Claude Code (new session). Toggle with `!tt off` / `!tt on`; input translation: `tt input on`.'));
+    console.log(C.dim('\nNext: restart Claude Code (new session). Toggle with `!cctrans off` / `!cctrans on`; input translation: `cctrans input on`.'));
     return true;
   } finally {
     if (rl) rl.close();

package/src/transcript.js

@@ -49,7 +49,7 @@ function newestJsonlIn(dir) {
 // 3) globally newest .jsonl across all projects (the active session is
 //    almost always the most recently written one).
 function findTranscript(cwd) {
-  if (process.env.TT_TRANSCRIPT) return process.env.TT_TRANSCRIPT;
+  if (process.env.CCTRANS_TRANSCRIPT) return process.env.CCTRANS_TRANSCRIPT;
 
   const root = projectsRoot();
   const dir = path.join(root, slugForCwd(cwd || process.cwd()));