ghostty-bg 0.2.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Masa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,88 +1,94 @@
 # ghostty-bg (`gbg`)
 
-Per-directory background colors for Ghostty — one command per project.
+ディレクトリごとに Ghostty の背景色を切り替える小さな CLI。プロジェクトごとに 1 コマンド。
 
 https://github.com/user-attachments/assets/28d9a5a6-a82c-4da5-b39d-c8d9bf58036f
 
-`gbg` is a tiny, zero-dependency Node CLI. It sends the standard
-[OSC 11](https://invisible-island.net/xterm/ctlseqs/ctlseqs.html) escape
-sequence to recolor the current window instantly, and remembers the color per
-directory. With the shell hook installed, `cd` into a directory and its color
-is applied automatically — no Ghostty fork or special API required.
+`gbg` は依存ゼロの小さな Node 製 CLI です。標準の
+[OSC 11](https://invisible-island.net/xterm/ctlseqs/ctlseqs.html) エスケープ
+シーケンスを送って現在のウィンドウの背景色を即座に変え、その色を**ディレクトリ
+ごとに記憶**します。シェルフックを入れておけば、`cd` でそのディレクトリの色が
+自動で適用されます。Ghostty の fork や特別な API は不要です。
 
-## Install
+> [!TIP]
+> セットアップを自分でやらずに済ませたい場合は、この README をそのまま
+> Claude Code や Codex などのコーディングエージェントに渡して
+> 「この README の通りに gbg をインストールして設定して」と頼んでください。
+> インストールから zsh フックの追加まで代わりにやってくれます。
+
+## インストール
 
 ```sh
 npm install -g ghostty-bg
 ```
 
-Or run it without installing:
+インストールせずに試す場合:
 
 ```sh
 npx ghostty-bg --color dracula
 ```
 
-## Usage
+## 使い方
 
 ```sh
-gbg                     # random color, remembered for this directory
-gbg --color dracula     # a named theme
-gbg --color "#1a2b3c"   # a hex value (#rgb or #rrggbb)
-gbg teal                # shorthand for --color
-gbg --no-save tomato    # current window only, not remembered
-gbg --reset             # forget this directory's color, reset background
-gbg --list              # list available color names
-gbg shell-init          # print the zsh cd hook
-gbg --help              # show help
-gbg --version           # show version
+gbg                     # パレットからランダムに選び、このディレクトリに記憶
+gbg --color dracula     # 名前付きテーマ
+gbg --color "#1a2b3c"   # HEX 値 (#rgb または #rrggbb)
+gbg teal                # --color の短縮形
+gbg --no-save tomato    # 現在のウィンドウのみ（記憶しない）
+gbg --reset             # このディレクトリの色を忘れて背景をリセット
+gbg --list              # 利用可能な色名の一覧
+gbg shell-init          # zsh の cd フックを出力
+gbg --help              # ヘルプ
+gbg --version           # バージョン
 ```
 
-Short flags: `-c` (color), `-n` (no-save), `-r` (reset), `-l` (list),
-`-h` (help), `-v` (version).
+短縮フラグ: `-c` (color), `-n` (no-save), `-r` (reset), `-l` (list),
+`-h` (help), `-v` (version)。
 
-## Colors
+## 色の指定
 
-`--color` accepts three kinds of values:
+`--color` は 3 種類の値を受け付けます。
 
-- **Named themes** — `dracula`, `nord`, `gruvbox`, `tokyonight`,
-  `catppuccin`, `solarized`, `github-dark`, and ~40 more. Run `gbg --list`.
-- **CSS color names** — `red`, `teal`, `midnightblue`, `rebeccapurple`, ...
-- **Hex** — `#rgb` or `#rrggbb`, with or without the leading `#`.
+- **名前付きテーマ** — `dracula`, `nord`, `gruvbox`, `tokyonight`,
+  `catppuccin`, `solarized`, `github-dark` など約 40 種類。`gbg --list` で確認。
+- **CSS 色名** — `red`, `teal`, `midnightblue`, `rebeccapurple` など。
+- **HEX** — `#rgb` または `#rrggbb`（先頭の `#` は省略可）。
 
-Running `gbg` with no arguments picks a random color from a curated palette of
-dark, readable backgrounds.
+引数なしの `gbg` は、読みやすい暗色のパレットからランダムに 1 色を選びます。
 
-## Per-directory colors
+## ディレクトリごとの色
 
-By default `gbg` does two things:
+デフォルトで `gbg` は次の 2 つを行います。
 
-1. Recolors the **current window** immediately via OSC 11.
-2. Remembers the color for the **current directory**.
+1. 現在のウィンドウの背景色を OSC 11 で即座に変更する。
+2. その色を**現在のディレクトリ**に記憶する。
 
-To make `cd` apply the remembered color automatically, add the hook to your
-shell:
+`cd` で記憶した色を自動適用するには、シェルにフックを追加します。
 
 ```sh
-echo 'eval "$(gbg shell-init)"' >> ~/.zshrc
+grep -q 'gbg shell-init' ~/.zshrc || echo 'eval "$(gbg shell-init)"' >> ~/.zshrc
 ```
 
-After that:
+追加後の挙動:
 
-- `cd` into a remembered directory → its color is applied.
-- `cd` anywhere else → the background returns to your theme default.
-- `gbg --no-save` applies to the current window without remembering it.
-- `gbg --reset` forgets the current directory's color.
+- 記憶済みのディレクトリに `cd` する → その色が適用される。
+- それ以外の場所に `cd` する → 背景がテーマの既定色に戻る。
+- `gbg --no-save` は記憶せず、現在のウィンドウにだけ適用する。
+- `gbg --reset` は現在のディレクトリの色を忘れる。
 
-The hook is plain zsh and reads a small `paths` file with `awk`, so it adds no
-Node startup cost on `cd`. Colors are matched by exact directory.
+フックは純粋な zsh で、小さな `paths` ファイルを `awk` で読むだけなので、`cd`
+ごとに Node を起動するコストはかかりません。色は**ディレクトリの完全一致**で
+照合されます。
 
-## How It Works
+## 仕組み
 
-`gbg` writes `ESC ] 11 ; <color> BEL` to the terminal to set the background and
-`ESC ] 111 BEL` to reset it. Remembered colors live in
-`${XDG_CONFIG_HOME:-~/.config}/gbg/paths` as `<dir><TAB><#hex>` lines.
+`gbg` は背景設定に `ESC ] 11 ; <色> BEL`、リセットに `ESC ] 111 BEL` を
+ターミナルへ書き込みます。記憶した色は
+`${XDG_CONFIG_HOME:-~/.config}/gbg/paths` に `<ディレクトリ><TAB><#hex>` の
+行として保存されます。
 
-## Requirements
+## 必要環境
 
 - Node.js >= 18
-- A terminal that supports OSC 11 (Ghostty, iTerm2, most modern terminals)
+- OSC 11 に対応したターミナル（Ghostty, iTerm2 など大半のモダンターミナル）

package/bin/gbg.js

@@ -121,6 +121,9 @@ function main() {
       : process.cwd();
 
   if (values.reset) {
+    if (values.color || positionals[0]) {
+      console.error("gbg: --reset ignores any color argument");
+    }
     resetBackground();
     const had = clearPathColor(cwd);
     console.error(
@@ -152,8 +155,11 @@ function main() {
   console.error(`gbg: background → ${label}`);
 
   if (!values["no-save"]) {
-    setPathColor(cwd, result.hex);
-    console.error(`gbg: remembered for ${cwd} (applies when you cd here)`);
+    if (setPathColor(cwd, result.hex)) {
+      console.error(`gbg: remembered for ${cwd} (applies when you cd here)`);
+    } else {
+      console.error("gbg: applied but not remembered (path contains a tab or newline)");
+    }
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ghostty-bg",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Change your Ghostty (or any OSC 11 terminal) background color with a single command.",
   "author": "Masa",
   "homepage": "https://github.com/MASAKASUNO1/ghostty-path-bg#readme",

package/src/paths.js

@@ -34,9 +34,13 @@ function write(map) {
 }
 
 export function setPathColor(dir, hex) {
+  // TAB and newline are the file's field/record separators; a path containing
+  // either would corrupt unrelated entries, so refuse to store it.
+  if (dir.includes("\t") || dir.includes("\n")) return false;
   const map = read();
   map.set(dir, hex);
   write(map);
+  return true;
 }
 
 export function clearPathColor(dir) {