設定ファイル

設定ファイルは TOML で書きます。languages.toml は Helix と互換があります。Helix から移る人は、languages.toml を ~/.config/shijimi/ にコピーしてください。

読み込む順番

次の順に読み込みます。後のものが優先されます。

1. 組み込みの既定値
2. ~/.config/shijimi/languages.toml、~/.config/shijimi/config.toml

3. プロジェクトの .shijimi/languages.toml、.shijimi/config.toml

4. languages.toml には言語サーバーを書きます（LSP）。

5. config.toml にはそれ以外を書きます（このページ）。
6. 実行中に :config-reload を実行すると、読み直します。
7. [agent] は ~/.config/shijimi/config.toml からだけ読みます（AI エージェント連携）。

config.toml の例

theme = "github_dark"
keymap = "helix"          # "vscode" で VS Code 風の操作
ui-language = "en"        # 画面の文字の言語。"en"（既定）または "ja"

[editor]
line-number = "relative"  # 行番号の表示
file-icons = true         # ファイルツリーの Nerd Font アイコン。false で ▸/▾ 表示
mermaid-command = "mmdc -q -i {in} -o {out} -b transparent -s 2"  # 空で無効
watch-files = true        # 他のプロセスによるファイル変更を反映する
mouse-hover = true        # 単語にマウスを乗せるとホバーを表示する

# インデントガイド（インデントごとの薄い縦線）。false で無効
[editor.indent-guides]
render = true

# 自動保存（既定で有効。編集が 1 秒止まると保存。名前のないファイルは対象外）
[editor.auto-save.after-delay]
enable = true
timeout = 1000            # ミリ秒

[search]
exclude = ["*.lock", "dist/**"]
include = []

[browser]
listen-host = "127.0.0.1"

# ~/.config/shijimi/config.toml だけで有効
[agent]
command = "claude-agent-acp"
args = []

項目

項目	説明	詳しいページ
theme	テーマ	このページの「テーマ」
keymap	helix（既定）または vscode	編集（VS Code モード）
ui-language	画面の文字（ステータス行・コマンドパレット・提案パネル・エラー・shj --help）の言語。en（英語、既定）または ja（日本語）。LANG などの環境変数からは選びません。ほかの値は無視して英語になります。:config-reload で切り替わります	—
editor.line-number	行番号の表示。absolute または relative	—
editor.file-icons	ファイルツリーのアイコン	ファイルと検索
editor.mermaid-command	mermaid を PNG にするコマンド	プレビュー
editor.watch-files	外部での変更を反映するか	ファイルと検索
editor.indent-guides.render	インデントガイドを描くか（既定 true）	—
editor.mouse-hover	マウスを乗せたときにホバーを表示するか	LSP
editor.auto-save.after-delay	自動保存	ファイルと検索
[[language]] の formatter	:fmt で動かす整形コマンド（languages.toml）	LSP
search.exclude / search.include	全体検索の除外 / 包含	ファイルと検索
[keys.normal] [keys.insert] [keys.select]	Helix モードのキーの差し替え（~/.config/shijimi/ だけ）	編集（Helix モード）
browser.listen-host	ポート転送の待ち受けアドレス	外部ブラウザとポート転送
agent.command / agent.args / agent.environment	提案パネルが使う ACP エージェント	AI エージェント連携

テーマ

組み込みのテーマは 3 つです。

名前	説明
dark-plus	既定
github-dark	—
light-plus	—

Helix のテーマ名も使えます。github_dark* は github-dark に、github_light* と light は light-plus に対応付けます。

切り替える方法は次の 3 つです。

• config.toml に theme = "<名前>" と書く。
• 実行中に :theme <名前> を入力する。名前を省略すると一覧が出ます。
• コマンドパレットの「設定: テーマを切り替え」を選ぶ。

キーの差し替え

[keys.normal] [keys.insert] [keys.select] で Helix モードのキーを差し替えられます。書き方とコマンド名の一覧は 編集（Helix モード） にあります。~/.config/shijimi/config.toml からだけ読みます（プロジェクトの .shijimi/config.toml では無効）。