コンテンツにスキップ
konoma
konoma — 木と木の間から青空と日の光が覗く森

全画面で、すべてを見る。

konoma のアイデアはひとつ:「ツリーで選び、全画面でプレビューする」。 Markdown・画像・PDF・CSV テーブル・git の diff とコミットグラフを ターミナルの中でそのまま描画。AI コーディングエージェントの隣に 置くために設計されています。
はじめるチュートリアルGitHub で見る

konoma の特徴

Section titled “konoma の特徴”

全画面プレビュー

分割ペインはありません。ツリーも全画面、プレビューも全画面、切替は キー2つ。Markdown は装飾描画(表・Mermaid 図・インライン画像・操作できる チェックボックス)、コードはシンタックスハイライト、CSV は移動できる テーブル、画像/PDF/SVG は端末のグラフィックプロトコルによる実ピクセル表示。

AI ペア開発のために

左に konoma、右にコーディングエージェント。フォローモード(F)は エージェントが変更したファイルの diff を自動表示し、C は未コミット 変更の一覧、@path#L12-34 参照のコピーはキー1つ。会話に貼るだけで 行単位の指示ができます。

本物の git クライアント

stage / unstage / コミット・全画面 diff・log・ブランチ・自作レンダラの コミットグラフ(角ばった罫線・基準ブランチの固定)まで、ブラウザの中で 完結します。

設定駆動・安全第一

「フォーマット→ビューア」の対応もキーもすべて 1 つの TOML で宣言。 未知のファイルはクラッシュせず安全な画面に、削除は確認付きでゴミ箱へ、 壊れた設定でも UI は壊れません。

スクリーンショット

Section titled “スクリーンショット”
konoma のツアー — ツリー・全画面画像プレビュー・Markdown・git ガター付きコード・git グラフ

git ステータス色付きのツリービュー

自作レンダラによるコミットグラフ

Markdown プレビュー内で実画像として描かれた Mermaid 図と LaTeX 数式

アクター・活性化バー・alt ブロックを持つシーケンス図。konoma 自身の Mermaid レンダラによる描画

Markdown プレビューの表(セル内装飾・整列)・水平線・操作できるタスクリスト

Markdown プレビューの GitHub 形式アラート・自動リンク・絵文字・脚注

ドキュメント

Section titled “ドキュメント”
はじめるインストール・2画面モデル・5分ツアー。
チュートリアル7ステップのガイド付きツアー。ターミナルで操作しながら。
AI エージェントと働くフォローモード・変更ファイルビュー・@path 参照。
プレビューを使い倒すMarkdown・チェックボックス・テーブル・メディア・コピー。
Mermaid カタログ全 23 図種を konoma 自身が描いた一覧。
git スイート変更ハブ・diff・log・コミットグラフ・ブランチ。
ファイル・ブックマーク・タブ絞り込み・安全なファイル操作・ブックマーク・タブ。
設定リファレンス全オプション — UI・配色・プレビュールール・キー。
既定キーマップ画面ごとのキー一覧。すべて変更可能。

インストール

Section titled “インストール”
Terminal window
cargo binstall konoma       # プレビルドバイナリ(要 cargo-binstall)
# または
cargo install konoma        # ソースからビルド

主対象は macOS (Apple Silicon)です。Intel macOS・Linux x86_64 も CI で全テストが通り プレビルドも配布し、Linux では画像・PDF・Markdown のプレビューが kitty graphics で 描画されることを検証済みです(macOS より新しいため beta 扱い)。 画像はグラフィックプロトコルを話す端末なら実ピクセルで描かれます — kitty graphics (Ghostty など)・iTerm2・sixel。それ以外の端末では ハーフブロックの近似表示に落ちます。起動は:

Terminal window
konoma [DIR]

どの画面でも ? でヘルプが出ます。リポジトリの samples/tutorial.ja.md を konoma 自身で開くと、触りながら覚えるチュートリアルが始まります。