pinglet-cli 0.2.10 → 0.2.12

package/README.ja.md

@@ -0,0 +1,94 @@
+# Pinglet 💌
+
+**AIが考えている間、他の開発者のひと言に出会おう。**
+
+Claude Code がコードを直している間、「Befuddling…」のスピナーをただ眺めていたその場所に、
+他の開発者が残した短いメッセージ（**Ping**）が代わりに表示されます。
+
+![Pinglet デモ — Claude Code のスピナーの位置に他の開発者の Ping が表示される](docs/pinglet-demo.gif)
+
+```
+✶ 💌 "金曜午後のデプロイは来世にしましょう。" (12s · ↓ 1.2k tokens)
+```
+
+🌐 **ホームページ**: https://pinglet.halluci.co.kr/ja/
+
+🇺🇸 [English](./README.md) · 🇰🇷 [한국어](./README.ko.md)
+
+## はじめに
+
+```bash
+npm install -g pinglet-cli && pinglet install
+```
+
+これだけです。あとはいつも通り `claude` を実行するだけ。
+
+> インストール中に npm が `install-scripts` の警告を表示することがあります — 古い npm で
+> 初期設定を自動化していたスクリプトに関する案内で、無視して構いません。
+> 接続状態は `pinglet doctor` でいつでも確認できます。
+
+- 既存の statusline 設定がある場合は**バックアップした上で置き換えるか確認し**、アンインストール時に元に戻します。
+- Codex にも対応しています（experimental）— turn 完了時に macOS 通知で Ping が届きます。
+  通知が煩わしい場合があるためデフォルトでは無効になっており、必要なときだけ `pinglet install --codex` で有効にしてください。
+
+## Ping を送る
+
+Claude Code セッションの中からそのまま:
+
+```
+> /pinglet 今日もビルドが緑でありますように
+```
+
+またはターミナルから:
+
+```bash
+pinglet login          # GitHub ログイン — ブラウザが開き自動で完了します（初回のみ）
+pinglet post "メッセージ"
+```
+
+読むだけならログイン不要で、**投稿にのみ GitHub ログインが必要です。**
+自分の Ping がどれだけ届いたかは statusline ですぐ確認できます:
+
+```
+💌 自分の Ping "今日もビルドが緑でありますように" → 到達率 17%
+```
+
+## コマンド
+
+| コマンド | 説明 |
+|---|---|
+| `pinglet install` | Claude Code に接続（Codex は `--codex` でオプトイン） |
+| `pinglet login` | GitHub アカウントを連携（投稿に必要） |
+| `pinglet post "メッセージ"` | Ping を送る |
+| `pinglet ping` | いま表示されるメッセージをプレビュー |
+| `pinglet doctor` | インストール・接続状態を診断 |
+| `pinglet uninstall` | 接続解除と元の設定の復元 |
+
+## 安心して使えます
+
+- **トークン使用量 0** — メッセージは Claude Code の UI 領域（statusline/spinner）にのみ
+  表示され、モデルのコンテキストには一切入りません。API コストや応答品質に影響はありません。
+- **コードを読みません** — prompt、応答、コード、環境変数にはアクセスしません。
+  収集するのはインストール ID、OS の種類、クライアントのバージョン、メッセージ表示イベントだけです。
+- **ターミナルが遅くなりません** — 表示はローカルキャッシュを読むだけで、ネットワークは
+  バックグラウンドでのみ使用します。オフラインでも動作します。
+- **すべてのメッセージは審査を通ります** — URL・個人情報・制御文字・不適切な表現は
+  自動的にフィルタリングされます。問題のあるメッセージを見つけたら、下記の連絡先から
+  お知らせください。すぐに取り下げます。
+
+## アンインストール
+
+```bash
+pinglet uninstall            # 接続解除 + 元の設定を復元（npm から削除する前に！）
+npm uninstall -g pinglet-cli
+```
+
+ローカルデータ（`~/.pinglet`）まで削除するには `pinglet uninstall --purge`。
+
+## 利用規約とプライバシーポリシー
+
+ログインしてメッセージを投稿すると、以下の文書に同意したものとみなされます。
+
+- [利用規約](https://pinglet.halluci.co.kr/terms) · [プライバシーポリシー](https://pinglet.halluci.co.kr/privacy)
+
+お問い合わせ・フィードバック: halluci-data@naver.com · [GitHub Issues](https://github.com/mabyko/pinglet-client/issues)

package/README.ko.md

@@ -0,0 +1,95 @@
+# Pinglet 💌
+
+**AI가 생각하는 동안, 다른 개발자의 한 줄을 만나세요.**
+
+Claude Code가 코드를 고치는 동안 "Befuddling…" 스피너만 바라보던 그 자리에,
+다른 개발자들이 남긴 짧은 메시지(**Ping**)가 대신 표시됩니다.
+
+![Pinglet 데모 — Claude Code 스피너 자리에 다른 개발자의 Ping이 표시된다](docs/pinglet-demo.gif)
+
+```
+✶ 💌 "금요일 오후 배포는 다음 생에 합시다." (12s · ↓ 1.2k tokens)
+```
+
+🌐 **홈페이지**: https://pinglet.halluci.co.kr
+
+🇺🇸 [English](./README.md) · 🇯🇵 [日本語](./README.ja.md)
+
+## 시작하기
+
+```bash
+npm install -g pinglet-cli && pinglet install
+```
+
+이게 전부입니다. 이후는 평소처럼 `claude`를 실행하기만 하면 돼요.
+
+> 설치 중 npm이 `install-scripts` 경고를 보여줄 수 있습니다 — 구버전 npm에서
+> 초기 설정을 자동화하던 스크립트에 대한 안내로, 무시해도 됩니다.
+> 연결 상태는 `pinglet doctor`로 언제든 확인할 수 있어요.
+
+- 기존 statusline 설정이 있다면 **백업 후 교체할지 물어보고**, 제거 시 원래대로 복원합니다.
+- Codex도 지원합니다(experimental) — turn 완료 시 macOS 알림으로 Ping이 도착합니다.
+  알림 방식이 시끄러울 수 있어 기본 설치에서는 제외되며, 원할 때만 `pinglet install --codex`로 켜세요.
+
+## Ping 보내기
+
+Claude Code 세션 안에서 바로:
+
+```
+> /pinglet 오늘도 빌드가 초록불이길
+```
+
+또는 터미널에서:
+
+```bash
+pinglet login          # GitHub 로그인 — 브라우저가 열리고 자동으로 완료됩니다 (최초 1회)
+pinglet post "메시지"
+```
+
+읽기는 로그인 없이 가능하고, **작성에만 GitHub 로그인이 필요합니다.**
+내가 보낸 Ping이 얼마나 퍼졌는지는 statusline에서 바로 확인됩니다:
+
+```
+💌 내 Ping "오늘도 빌드가 초록불이길" → 도달률 17%
+```
+
+## 명령어
+
+| 명령 | 설명 |
+|---|---|
+| `pinglet install` | Claude Code 연결 (Codex는 `--codex`로 opt-in) |
+| `pinglet login` | GitHub 계정 연결 (메시지 작성에 필요) |
+| `pinglet post "메시지"` | Ping 보내기 |
+| `pinglet ping` | 지금 표시될 메시지 미리보기 |
+| `pinglet doctor` | 설치·연결 상태 진단 |
+| `pinglet uninstall` | 연결 해제 및 기존 설정 복원 |
+
+## 안심하고 쓰세요
+
+- **토큰 사용량 0** — 메시지는 Claude Code의 UI 영역(statusline/spinner)에만
+  표시되고 모델 컨텍스트에는 전혀 들어가지 않습니다. API 비용과 응답 품질에
+  영향이 없습니다.
+- **코드를 읽지 않습니다** — prompt, 응답, 코드, 환경변수에 접근하지 않습니다.
+  수집하는 것은 설치 ID, OS 종류, 클라이언트 버전, 메시지 노출 이벤트뿐입니다.
+- **터미널이 느려지지 않습니다** — 표시는 로컬 캐시만 읽어서 그리며, 네트워크는
+  백그라운드에서만 사용합니다. 오프라인에서도 동작합니다.
+- **모든 메시지는 검수를 거칩니다** — URL·개인정보·제어문자·부적절한 표현은
+  자동으로 걸러지며, 문제가 되는 메시지는 발견 시 바로 내려주세요
+  (아래 문의·피드백 링크).
+
+## 제거
+
+```bash
+pinglet uninstall            # 연결 해제 + 기존 설정 복원 (npm 제거보다 먼저!)
+npm uninstall -g pinglet-cli
+```
+
+로컬 데이터(`~/.pinglet`)까지 지우려면 `pinglet uninstall --purge`.
+
+## 약관 및 개인정보처리방침
+
+로그인하여 메시지를 작성하면 아래 문서에 동의한 것으로 간주됩니다.
+
+- [이용약관](https://pinglet.halluci.co.kr/terms) · [개인정보처리방침](https://pinglet.halluci.co.kr/privacy)
+
+문의·피드백: halluci-data@naver.com · [GitHub Issues](https://github.com/mabyko/pinglet-client/issues)

package/README.md

@@ -1,93 +1,96 @@
 # Pinglet 💌
 
-**AI가 생각하는 동안, 다른 개발자의 한 줄을 만나세요.**
+**While the AI thinks, meet a line from another developer.**
 
-Claude Code가 코드를 고치는 동안 "Befuddling…" 스피너만 바라보던 그 자리에,
-다른 개발자들이 남긴 짧은 메시지(**Ping**)가 대신 표시됩니다.
+That spot where you used to stare at Claude Code's "Befuddling…" spinner
+now shows short messages (**Pings**) left by other developers.
 
-![Pinglet 데모 — Claude Code 스피너 자리에 다른 개발자의 Ping이 표시된다](docs/pinglet-demo.gif)
+![Pinglet demo — another developer's Ping shown in place of the Claude Code spinner](docs/pinglet-demo.gif)
 
 ```
-✶ 💌 "금요일 오후 배포는 다음 생에 합시다." (12s · ↓ 1.2k tokens)
+✶ 💌 "Friday-afternoon deploys are a next-life problem." (12s · ↓ 1.2k tokens)
 ```
 
-🌐 **홈페이지**: https://pinglet.halluci.co.kr
+🌐 **Website**: https://pinglet.halluci.co.kr/en/
 
-## 시작하기
+🇰🇷 [한국어](./README.ko.md) · 🇯🇵 [日本語](./README.ja.md)
+
+## Getting started
 
 ```bash
 npm install -g pinglet-cli && pinglet install
 ```
 
-이게 전부입니다. 이후는 평소처럼 `claude`를 실행하기만 하면 돼요.
+That's it. Just run `claude` as usual.
 
-> 설치 중 npm이 `install-scripts` 경고를 보여줄 수 있습니다 — 구버전 npm에서
-> 초기 설정을 자동화하던 스크립트에 대한 안내로, 무시해도 됩니다.
-> 연결 상태는 `pinglet doctor`로 언제든 확인할 수 있어요.
+> npm may show an `install-scripts` warning during installation — it refers to a
+> script that used to automate setup on older npm versions and can be ignored.
+> You can check the connection anytime with `pinglet doctor`.
 
-- 기존 statusline 설정이 있다면 **백업 후 교체할지 물어보고**, 제거 시 원래대로 복원합니다.
-- Codex도 지원합니다(experimental) — turn 완료 시 macOS 알림으로 Ping이 도착합니다.
-  알림 방식이 시끄러울 수 있어 기본 설치에서는 제외되며, 원할 때만 `pinglet install --codex`로 켜세요.
+- If you already have a statusline configured, Pinglet **asks before replacing it (after backing it up)** and restores the original on uninstall.
+- Codex is supported too (experimental) — a Ping arrives as a macOS notification when a turn completes.
+  Since notifications can be noisy, it's excluded from the default install; opt in with `pinglet install --codex`.
 
-## Ping 보내기
+## Sending a Ping
 
-Claude Code 세션 안에서 바로:
+Right from a Claude Code session:
 
 ```
-> /pinglet 오늘도 빌드가 초록불이길
+> /pinglet may your build stay green today
 ```
 
-또는 터미널에서:
+Or from the terminal:
 
 ```bash
-pinglet login          # GitHub 로그인 — 브라우저가 열리고 자동으로 완료됩니다 (최초 1회)
-pinglet post "메시지"
+pinglet login          # GitHub login — opens a browser and completes automatically (once)
+pinglet post "message"
 ```
 
-읽기는 로그인 없이 가능하고, **작성에만 GitHub 로그인이 필요합니다.**
-내가 보낸 Ping이 얼마나 퍼졌는지는 statusline에서 바로 확인됩니다:
+Reading requires no login; **only posting requires a GitHub login.**
+You can see how far your Ping has traveled right in the statusline:
 
 ```
-💌 내 Ping "오늘도 빌드가 초록불이길" → 도달률 17%
+💌 My Ping "may your build stay green today" → reach 17%
 ```
 
-## 명령어
+## Commands
 
-| 명령 | 설명 |
+| Command | Description |
 |---|---|
-| `pinglet install` | Claude Code 연결 (Codex는 `--codex`로 opt-in) |
-| `pinglet login` | GitHub 계정 연결 (메시지 작성에 필요) |
-| `pinglet post "메시지"` | Ping 보내기 |
-| `pinglet ping` | 지금 표시될 메시지 미리보기 |
-| `pinglet doctor` | 설치·연결 상태 진단 |
-| `pinglet uninstall` | 연결 해제 및 기존 설정 복원 |
-
-## 안심하고 쓰세요
-
-- **토큰 사용량 0** — 메시지는 Claude Code의 UI 영역(statusline/spinner)에만
-  표시되고 모델 컨텍스트에는 전혀 들어가지 않습니다. API 비용과 응답 품질에
-  영향이 없습니다.
-- **코드를 읽지 않습니다** — prompt, 응답, 코드, 환경변수에 접근하지 않습니다.
-  수집하는 것은 설치 ID, OS 종류, 클라이언트 버전, 메시지 노출 이벤트뿐입니다.
-- **터미널이 느려지지 않습니다** — 표시는 로컬 캐시만 읽어서 그리며, 네트워크는
-  백그라운드에서만 사용합니다. 오프라인에서도 동작합니다.
-- **모든 메시지는 검수를 거칩니다** — URL·개인정보·제어문자·부적절한 표현은
-  자동으로 걸러지며, 문제가 되는 메시지는 발견 시 바로 내려주세요
-  (아래 문의·피드백 링크).
-
-## 제거
+| `pinglet install` | Connect to Claude Code (opt in to Codex with `--codex`) |
+| `pinglet login` | Link your GitHub account (required for posting) |
+| `pinglet post "message"` | Send a Ping |
+| `pinglet ping` | Preview the message that would be shown now |
+| `pinglet doctor` | Diagnose installation and connection status |
+| `pinglet uninstall` | Disconnect and restore your previous settings |
+
+## Safe to use
+
+- **Zero token usage** — messages are shown only in Claude Code's UI area
+  (statusline/spinner) and never enter the model context. No impact on API cost
+  or response quality.
+- **Never reads your code** — no access to prompts, responses, code, or
+  environment variables. The only data collected: an install ID, OS type,
+  client version, and message-impression events.
+- **Doesn't slow down your terminal** — rendering reads only a local cache;
+  the network is used in the background only. Works offline too.
+- **Every message is moderated** — URLs, personal information, control
+  characters, and inappropriate content are filtered automatically. If you spot
+  a problematic message, report it via the links below and we'll take it down.
+
+## Uninstall
 
 ```bash
-pinglet uninstall            # 연결 해제 + 기존 설정 복원 (npm 제거보다 먼저!)
+pinglet uninstall            # disconnect + restore previous settings (do this before removing the npm package!)
 npm uninstall -g pinglet-cli
 ```
 
-로컬 데이터(`~/.pinglet`)까지 지우려면 `pinglet uninstall --purge`.
+To also remove local data (`~/.pinglet`), run `pinglet uninstall --purge`.
 
-## 약관 및 개인정보처리방침
+## Terms & Privacy
 
-로그인하여 메시지를 작성하면 아래 문서에 동의한 것으로 간주됩니다.
+By logging in and posting messages you agree to the following:
 
-- [이용약관](https://pinglet.halluci.co.kr/terms) · [개인정보처리방침](https://pinglet.halluci.co.kr/privacy)
+- [Terms of Service](https://pinglet.halluci.co.kr/terms) · [Privacy Policy](https://pinglet.halluci.co.kr/privacy)
 
-문의·피드백: halluci-data@naver.com · [GitHub Issues](https://github.com/mabyko/pinglet-client/issues)
+Contact & feedback: halluci-data@naver.com · [GitHub Issues](https://github.com/mabyko/pinglet-client/issues)

package/dist/adapters/claude.js

@@ -180,9 +180,25 @@ function writeSettings(settings, expectedMtimeMs) {
     if (settingsMtimeMs() !== expectedMtimeMs)
         return false;
     // settings.json은 Claude Code가 수시로 읽는 파일이라 tmp+rename으로 원자적으로 쓴다.
-    const tmp = SETTINGS_PATH + ".pinglet-tmp";
-    fs.writeFileSync(tmp, JSON.stringify(settings, null, 2) + "\n");
-    fs.renameSync(tmp, SETTINGS_PATH);
+    // tmp 이름에 pid를 붙여 프로세스마다 다르게 만든다 — 여러 세션의 statusline이
+    // 동시에 돌면 같은 tmp에 겹쳐 쓰게 되고, writeFileSync는 truncate 후 쓰기라
+    // 짧은 내용 뒤에 긴 내용의 꼬리가 남은 채로 rename 되어 settings.json이 깨진다.
+    // rename 자체는 tmp 이름과 무관하게 원자적이라 이것만으로 충분하다.
+    const tmp = `${SETTINGS_PATH}.pinglet-tmp.${process.pid}`;
+    try {
+        fs.writeFileSync(tmp, JSON.stringify(settings, null, 2) + "\n");
+        fs.renameSync(tmp, SETTINGS_PATH);
+    }
+    catch (error) {
+        // rename 전에 실패하면 tmp가 남는다 — 이름이 pid별로 달라 방치하면 쌓인다.
+        try {
+            fs.unlinkSync(tmp);
+        }
+        catch {
+            // 이미 없으면 무시
+        }
+        throw error;
+    }
     return true;
 }
 function isPingletTip(tip) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pinglet-cli",
-  "version": "0.2.10",
-  "description": "AI가 생각하는 동안 다른 개발자의 Ping을 만나는 메시지 네트워크 — Claude Code / Codex integration",
+  "version": "0.2.12",
+  "description": "Short messages from other developers shown in your Claude Code spinner while the AI thinks — zero tokens, never reads your code. Claude Code / Codex integration",
   "license": "MIT",
   "repository": {
     "type": "git",