cckeep 0.1.0 → 0.1.2

package/README.ja.md

@@ -28,18 +28,31 @@
 ## クイックスタート
 
 ```sh
-npx cckeep install
+npm install -g cckeep
+cckeep install
 ```
 
 バックグラウンドジョブを登録します(macOS は launchd、Linux は systemd user timer)。15秒ごとに確認し、死んでいるものを繋ぎ直します。
 
-条件が一つあります。**Claude Code が tmux の中で動いていること。** 素のターミナルで起動したセッションには別プロセスから入力を送る手段がなく、どんなツールでも手が出せません。→ [tmux で Claude Code を動かす](#tmux-で-claude-code-を動かす)
+`npx cckeep install` ではなくグローバルに入れてください。登録されたジョブはインストール先の cckeep を実行しますが、npx のキャッシュは使い捨てです。そこを指すジョブはキャッシュが消された瞬間に、黙って動かなくなります — 監視ツールが持ってはいけない唯一の壊れ方です。そのため `cckeep install` は npx のパスからの登録を拒否します。
+
+入れる前に様子を見るだけなら `npx` で構いません。以下の2つは何も変更しません。
 
 ```sh
-npx cckeep            # いま何が見えているか(何も変更しません)
+npx cckeep            # いま何が見えているか
 npx cckeep doctor     # tmux・ペイン・スケジューラの確認
 ```
 
+**インストール直後に `command not found: cckeep` と出たら**、shim 方式のバージョン管理ツールを使っています。`nodenv` や `asdf` は新しく入った実行ファイルを PATH に出すのに rehash が必要で、`nvm` はシェルを開き直す必要があります。
+
+```sh
+nodenv rehash      # nodenv
+asdf reshim nodejs # asdf
+# nvm: 新しいシェルを開くだけ
+```
+
+条件が一つあります。**Claude Code が tmux の中で動いていること。** 素のターミナルで起動したセッションには別プロセスから入力を送る手段がなく、どんなツールでも手が出せません。→ [tmux で Claude Code を動かす](#tmux-で-claude-code-を動かす)
+
 > 机に戻る手間が省けたなら、⭐ が同じ問題を抱えている人に届く助けになります。
 
 ## 作業中のセッションには打ち込みません
@@ -99,13 +112,31 @@ cc() {
     esac
   done
   local session="claude-$(basename "$PWD")-$(printf '%s' "$PWD" | cksum | cut -d' ' -f1)"
-  if [ -n "$TMUX" ]; then command claude "$@"
-  elif tmux has-session -t "=$session" 2>/dev/null; then tmux attach-session -t "=$session"
-  else tmux new-session -s "$session" -c "$PWD" claude "$@"
+  if [ -n "$TMUX" ]; then command claude "$@"; return; fi
+  if ! tmux has-session -t "=$session" 2>/dev/null; then
+    tmux new-session -s "$session" -c "$PWD" claude "$@"; return
   fi
+
+  # tmux セッションは中の claude より長生きするので、そのままアタッチすると
+  # 会話が消えた素のシェルに落ちることがある。その場合は会話を呼び戻す。
+  local pane_cmd cmd
+  pane_cmd=$(tmux list-panes -t "=$session:" -F '#{pane_current_command}' 2>/dev/null | head -1)
+  case "$pane_cmd" in
+    zsh|bash|sh|fish)
+      cmd="claude"
+      case " $* " in
+        *" -c "*|*" --continue "*|*" -r "*|*" --resume "*|*" --session-id "*) ;;
+        *) cmd="$cmd --continue" ;;
+      esac
+      [ $# -gt 0 ] && cmd="$cmd $*"
+      tmux send-keys -t "=$session:" "$cmd" C-m ;;
+  esac
+  tmux attach-session -t "=$session"
 }
 ```
 
+`cc -c` と `cc --continue` はそのまま使えます — フラグは Claude Code にそのまま渡ります。上のブロックが埋めるのは、フラグでは救えないケース(tmux セッションだけ残って中の Claude Code が終了している状態)です。
+
 あわせて `~/.tmux.conf` に2行必要です。これが無いと tmux 内で Shift+Enter とデスクトップ通知が壊れます([公式の案内](https://code.claude.com/docs/en/terminal-config#configure-tmux))。
 
 ```sh

package/README.md

@@ -28,18 +28,33 @@ Either way you find out the same way: you reach for your phone, and the session
 ## Quick start
 
 ```sh
-npx cckeep install
+npm install -g cckeep
+cckeep install
 ```
 
 That registers a background job — launchd on macOS, a systemd user timer on Linux — that checks every 15 seconds and re-arms whatever went dead.
 
-One requirement: **Claude Code has to be running inside tmux.** A session started in a bare terminal cannot be reached from another process, so there is nothing any tool can do for it. See [Running Claude Code in tmux](#running-claude-code-in-tmux).
+Install it globally rather than running `npx cckeep install`. The scheduled job runs cckeep from wherever it was installed, and npx's cache is throwaway: a job pointing into it keeps working until the cache is cleared and then stops, silently — the one failure a watchdog must not have. `cckeep install` refuses to schedule from an npx path for that reason.
+
+To look before installing anything, `npx` is fine — neither of these changes a thing:
 
 ```sh
-npx cckeep            # what it sees right now — changes nothing
+npx cckeep            # what it sees right now
 npx cckeep doctor     # check tmux, panes, and the scheduler
 ```
 
+**`command not found: cckeep` right after installing?** You are on a shim-based
+version manager. `nodenv` and `rbenv`-style setups need a rehash before a newly
+installed binary appears on `PATH`, and `nvm` needs a new shell:
+
+```sh
+nodenv rehash     # nodenv
+asdf reshim nodejs # asdf
+# nvm: just open a new shell
+```
+
+One requirement: **Claude Code has to be running inside tmux.** A session started in a bare terminal cannot be reached from another process, so there is nothing any tool can do for it. See [Running Claude Code in tmux](#running-claude-code-in-tmux).
+
 > If cckeep saved you a walk back to your desk, a ⭐ helps other Remote Control users find it.
 
 ## It will not type into a session that is working
@@ -99,13 +114,33 @@ cc() {
     esac
   done
   local session="claude-$(basename "$PWD")-$(printf '%s' "$PWD" | cksum | cut -d' ' -f1)"
-  if [ -n "$TMUX" ]; then command claude "$@"
-  elif tmux has-session -t "=$session" 2>/dev/null; then tmux attach-session -t "=$session"
-  else tmux new-session -s "$session" -c "$PWD" claude "$@"
+  if [ -n "$TMUX" ]; then command claude "$@"; return; fi
+  if ! tmux has-session -t "=$session" 2>/dev/null; then
+    tmux new-session -s "$session" -c "$PWD" claude "$@"; return
   fi
+
+  # The tmux session outlives the claude process inside it, so attaching can
+  # drop you at a bare shell with the conversation gone. Bring it back.
+  local pane_cmd cmd
+  pane_cmd=$(tmux list-panes -t "=$session:" -F '#{pane_current_command}' 2>/dev/null | head -1)
+  case "$pane_cmd" in
+    zsh|bash|sh|fish)
+      cmd="claude"
+      case " $* " in
+        *" -c "*|*" --continue "*|*" -r "*|*" --resume "*|*" --session-id "*) ;;
+        *) cmd="$cmd --continue" ;;
+      esac
+      [ $# -gt 0 ] && cmd="$cmd $*"
+      tmux send-keys -t "=$session:" "$cmd" C-m ;;
+  esac
+  tmux attach-session -t "=$session"
 }
 ```
 
+`cc -c` and `cc --continue` work as you'd expect — the flag is passed straight
+through to Claude Code. The block above covers the case the flag can't: a tmux
+session whose Claude Code process has already exited.
+
 Claude Code also needs two lines in `~/.tmux.conf`, or Shift+Enter and desktop notifications break inside tmux ([official guidance](https://code.claude.com/docs/en/terminal-config#configure-tmux)):
 
 ```sh

package/bin/cckeep.js

@@ -130,6 +130,10 @@ async function main() {
     }
     case 'install': {
       const res = scheduler.install({ interval: config.interval });
+      if (res.kind === 'ephemeral') {
+        console.error(t.ephemeral(res.path));
+        process.exit(1);
+      }
       if (res.kind === 'unsupported') {
         console.log(t.unsupported);
         process.exit(1);
@@ -155,6 +159,11 @@ async function main() {
         ['tmux server', bin && tmux.hasServer() ? t.doctorOk : t.doctorFail],
         ['claude panes', String(claudePanes.length)],
         ['scheduler', scheduler.isInstalled() ? t.doctorOk : t.doctorFail],
+        [t.scheduledPath, (() => {
+          const cli = scheduler.scheduledCli();
+          if (!cli) return '—';
+          return existsSync(cli) ? cli : `${cli}  ${t.scheduledMissing}`;
+        })()],
         ['home', homeDir()],
         ['config', existsSync(configPath()) ? configPath() : `${configPath()} (defaults)`],
         ['state', statePath()],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cckeep",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Keeps Claude Code Remote Control from silently going dead. Re-arms the sessions its 31-second retry budget gives up on — local, tmux-native, zero dependencies.",
   "type": "module",
   "bin": {

package/src/i18n.js

@@ -21,6 +21,9 @@ const en = {
   installFailed: (kind) => `Wrote the ${kind} unit, but could not load it. Load it manually, or run \`cckeep watch\` in a terminal.`,
   uninstalled: (kind) => `Removed the ${kind} job.`,
   unsupported: 'Automatic scheduling supports macOS (launchd) and Linux (systemd user timers). Elsewhere, run `cckeep watch` under your own supervisor.',
+  ephemeral: (p) => `Refusing to schedule: this copy of cckeep lives in npm's throwaway npx cache\n  ${p}\nA scheduled job pointing there stops working the moment the cache is cleared — silently. Install it properly first:\n\n  npm install -g cckeep && cckeep install\n`,
+  scheduledPath: 'scheduled cmd',
+  scheduledMissing: 'MISSING — run `cckeep install` again',
   noLog: 'No log yet.',
   doctorOk: 'ok',
   doctorFail: 'missing',
@@ -49,6 +52,9 @@ const ja = {
   installFailed: (kind) => `${kind} の定義は書きましたが、読み込みに失敗しました。手動で読み込むか、ターミナルで \`cckeep watch\` を実行してください。`,
   uninstalled: (kind) => `${kind} のジョブを削除しました。`,
   unsupported: '自動スケジュール登録は macOS (launchd) と Linux (systemd user timer) に対応しています。それ以外では `cckeep watch` を任意の常駐手段で動かしてください。',
+  ephemeral: (p) => `登録を中止しました: この cckeep は npm の使い捨て npx キャッシュ内にあります\n  ${p}\nここを指すジョブは、キャッシュが消された瞬間に黙って動かなくなります。先に正式にインストールしてください:\n\n  npm install -g cckeep && cckeep install\n`,
+  scheduledPath: '登録先',
+  scheduledMissing: '見つかりません — `cckeep install` を再実行してください',
   noLog: 'ログはまだありません。',
   doctorOk: 'ok',
   doctorFail: '未検出',

package/src/scheduler.js

@@ -1,5 +1,5 @@
 import { execFileSync } from 'node:child_process';
-import { mkdirSync, writeFileSync, existsSync, unlinkSync } from 'node:fs';
+import { mkdirSync, writeFileSync, readFileSync, existsSync, unlinkSync } from 'node:fs';
 import { homedir, platform } from 'node:os';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -10,6 +10,16 @@ function cliPath() {
   return fileURLToPath(new URL('../bin/cckeep.js', import.meta.url));
 }
 
+/**
+ * `npx cckeep` runs out of npm's throwaway cache. Baking that path into a
+ * launchd job or systemd unit produces a scheduler that works today and stops
+ * forever the first time the cache is evicted — silently, which is the one
+ * failure this tool must not have. Refuse instead, and ask for a real install.
+ */
+export function isEphemeralPath(p) {
+  return /[\\/]_npx[\\/]/.test(p) || /[\\/]\.npm[\\/]_cacache[\\/]/.test(p);
+}
+
 function nodePath() {
   return process.execPath;
 }
@@ -83,6 +93,9 @@ function run(cmd, args) {
 }
 
 export function install({ interval }) {
+  const cli = cliPath();
+  if (isEphemeralPath(cli)) return { kind: 'ephemeral', path: cli, ok: false };
+
   const os = platform();
   if (os === 'darwin') {
     const p = plistPath();
@@ -132,3 +145,29 @@ export function isInstalled() {
   if (os === 'linux') return existsSync(join(systemdDir(), 'cckeep.timer'));
   return false;
 }
+
+/**
+ * The cckeep path the installed scheduler will actually run. Read back from the
+ * unit rather than recomputed, so `doctor` can catch a job left pointing at a
+ * copy that has since been moved or deleted.
+ */
+export function scheduledCli() {
+  try {
+    const os = platform();
+    if (os === 'darwin') {
+      const p = plistPath();
+      if (!existsSync(p)) return null;
+      const xml = readFileSync(p, 'utf8');
+      const args = [...xml.matchAll(/<string>([^<]*)<\/string>/g)].map((m) => m[1]);
+      return args.find((a) => a.endsWith('cckeep.js')) ?? null;
+    }
+    if (os === 'linux') {
+      const p = join(systemdDir(), 'cckeep.service');
+      if (!existsSync(p)) return null;
+      const unit = readFileSync(p, 'utf8');
+      const line = unit.match(/^ExecStart=(.*)$/m)?.[1] ?? '';
+      return line.split(/\s+/).find((a) => a.endsWith('cckeep.js')) ?? null;
+    }
+  } catch {}
+  return null;
+}