設定

ドキュメント作成中

一部の内容はまだ不完全な場合があります。

ThinkTerm は WezTerm と同じく Lua ファイルで設定します。設定項目名、モジュール名、構文はいずれも変更されていません — ThinkTerm の設定ファイルも次の行から始まります。

local wezterm = require 'wezterm'

異なるのは、ファイルをどこから読むか、そしてデータをどこへ書くかだけです。

設定ファイルの探索順

ThinkTerm は次の順で探し、最初に見つかったファイルを読み込みます。

1. $THINKTERM_CONFIG_FILE
2. $WEZTERM_CONFIG_FILE
3. 実行ファイルと同じディレクトリの thinkterm.lua — Windows のみ
4. 実行ファイルと同じディレクトリの wezterm.lua — Windows のみ
5. ~/.config/thinkterm/thinkterm.lua
6. ~/.config/thinkterm/wezterm.lua
7. ~/.thinkterm.lua

$THINKTERM_CONFIG_DIR と $WEZTERM_CONFIG_DIR はこの探索には関与しません。これらは設定の読み込みが完了したあとに ThinkTerm が書き出すもので、読み込まれたファイルのあるディレクトリを指し、あなたが起動するプログラムから参照できるようにするためのものです。自分で設定しても、どの設定が選ばれるかは変わりません。

Windows 限定の 2 項目は意図的なものです。実行ファイルの隣に置かれた設定が最優先されることで、ThinkTerm を USB メモリに入れて持ち歩き、自分の設定がない、あるいは他人の設定が入っているマシンでも動かせます。

wezterm.lua というファイル名も残骸ではありません。既存の WezTerm 設定を、名前を変えずに ThinkTerm のディレクトリへ置けるようにするためのものです。

ThinkTerm が WezTerm のインストールから受け取るもの

あなたの WezTerm 設定ファイルは読み込まれません。上記の場所はいずれも ~/.config/wezterm/wezterm.lua を指しておらず、ThinkTerm がそこへ書き込むこともありません。

ただし分離は完全ではなく、知っておくべき経路が 2 つあります。

WEZTERM_CONFIG_FILE は尊重されます。 これは上の探索順に含まれるため、この変数が環境に設定されていれば（WezTerm をそのように構成していたなら十分あり得ます）、ThinkTerm はそれが指すファイルを読み込みます。THINKTERM_CONFIG_FILE を設定するか、WezTerm 側の変数を解除すれば、二つのインストールを分離できます。

WezTerm の設定ディレクトリは Lua モジュールとカラースキームの探索対象として残ります。 ~/.config/wezterm/ と ~/.wezterm/ は Lua の package.path に含まれ、~/.config/wezterm/colors/ はカラースキームの探索先になります。そのため ThinkTerm の設定で require 'mymodule' と書けば、WezTerm 用に書いたモジュールが見つかります。分離されているのは設定ファイル自体であって、ディレクトリ全体ではありません。

WezTerm からインポート

設定 › WezTerm からインポート は既存の WezTerm 設定を読み込み、選択したフィールドを ThinkTerm 自身のファイルへコピーします。これは一度きりのコピーであり、その後は二つのファイルは独立し、状態を共有することはありません。

インポートできるのは次の 15 項目です。

color_scheme、window_background_opacity、macos_window_background_blur、inactive_pane_hsb、font、font_size、line_height、cell_width、default_prog、default_cwd、front_end、window_decorations、disable_default_key_bindings、keys、key_tables

このリストが定めるのはインポート機能が代わりにコピーする範囲であって、ThinkTerm が対応している範囲ではありません。それ以外の WezTerm 設定項目も、ThinkTerm の設定ファイルに手で書けば同様に機能します。

データの保存場所

macOS

• 設定ファイル — ~/.config/thinkterm/
• ワークスペースデータ — ~/Library/Application Support/ThinkTerm/
• ターミナル状態 — ~/Library/Application Support/thinkterm/
• キャッシュ — ~/Library/Caches/thinkterm/

Linux

• 設定ファイル — ~/.config/thinkterm/
• ワークスペースデータ — ~/.local/share/ThinkTerm/
• ターミナル状態 — ~/.local/share/thinkterm/
• キャッシュ — ~/.cache/thinkterm/

Windows

• 設定ファイル — %USERPROFILE%\.config\thinkterm\
• ワークスペースデータ — %APPDATA%\ThinkTerm\
• ターミナル状態 — %APPDATA%\thinkterm\
• キャッシュ — %LOCALAPPDATA%\thinkterm\

ここには、つまずきやすい点が 2 つあります。

設定ファイルのパスはプラットフォームの慣習に従いません。 すべての OS で ~/.config/thinkterm/ が使われ、Windows も例外ではありません — %APPDATA% ではないのです。そのため設定とデータはどのプラットフォームでも別の場所に置かれます。Linux も同じで、設定は ~/.config の下、データは ~/.local/share の下です。

大文字小文字だけが異なる 2 つのデータディレクトリがあります。 ワークスペースデータ — Space・Project・Thread の構造、SSH ホスト帳、スニペット、暗号鍵 — は ThinkTerm/ に書かれます。ターミナルとマルチプレクサの状態は thinkterm/ に書かれます。macOS と Windows のファイルシステムは既定では大文字小文字を区別しないため、この 2 つは通常一つのディレクトリに統合されます — 大文字小文字を区別する APFS ボリュームでは統合されません。Linux では常に別々のディレクトリです。どこに置かれても、どちらも ThinkTerm のものです。

ノートの保管庫はこのいずれにも保存されません。あなたが選んだ、通常の Markdown ファイルが入ったディレクトリであり、ThinkTerm はその紐づけだけを記録します。

設定項目リファレンス

ほとんどの設定項目は WezTerm のものがそのまま使われているため、リファレンスは上流にあります。

• WezTerm の設定ファイル

注意点が 2 つあります。ThinkTerm は 2026 年 3 月 31 日に WezTerm から分岐したため、それ以降に上流へ追加された項目はまだ存在しない可能性があります。また ThinkTerm 独自の項目もあり、これらは上流のドキュメントには載っていません。

設定項目	制御する内容
agent_status_detection	セッション状態の検出を行うか
note_spellcheck_enabled	Markdown エディタのスペルチェック
note_remote_images_enabled	ノートでリモート URL の画像を読み込むか
note_reading_max_width	ノートの表示幅
right_sidebar_search_respects_gitignore	ファイル検索が無視対象のファイルを飛ばすか