---
title: konoma
description: 全画面プレビュー特化のターミナルファイルブラウザ。AI コーディングエージェントの隣で使うために作られた macOS 用ツール。
template: splash
hero:
  title: 全画面で、すべてを見る。
  tagline: >-
    konoma のアイデアはひとつ:「ツリーで選び、全画面でプレビューする」。
    Markdown・画像・PDF・CSV テーブル・git の diff とコミットグラフを
    ターミナルの中でそのまま描画。AI コーディングエージェントの隣に
    置くために設計されています。
  actions:
    - text: はじめる
      link: ./getting-started/
      icon: right-arrow
    - text: チュートリアル
      link: ./tutorial/
      icon: open-book
      variant: secondary
    - text: GitHub で見る
      link: https://github.com/LESIM-Co-Ltd/konoma
      icon: external
      variant: minimal
---

import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
import TerminalDemo from '../../../components/TerminalDemo.astro';

<TerminalDemo lang="ja" />

## konoma の特徴

<CardGrid>
	<Card title="全画面プレビュー" icon="document">
		分割ペインはありません。ツリーも全画面、プレビューも全画面、切替は
		キー2つ。Markdown は装飾描画(表・Mermaid 図・インライン画像・操作できる
		チェックボックス)、コードはシンタックスハイライト、CSV は移動できる
		テーブル、画像/PDF/SVG は kitty graphics による実ピクセル表示。
	</Card>
	<Card title="AI ペア開発のために" icon="rocket">
		左に konoma、右にコーディングエージェント。フォローモード(`F`)は
		エージェントが変更したファイルの diff を自動表示し、`C` は未コミット
		変更の一覧、`@path#L12-34` 参照のコピーはキー1つ。会話に貼るだけで
		行単位の指示ができます。
	</Card>
	<Card title="本物の git クライアント" icon="seti:git">
		stage / unstage / コミット・全画面 diff・log・ブランチ・自作レンダラの
		コミットグラフ(角ばった罫線・基準ブランチの固定)まで、ブラウザの中で
		完結します。
	</Card>
	<Card title="設定駆動・安全第一" icon="setting">
		「フォーマット→ビューア」の対応もキーもすべて 1 つの TOML で宣言。
		未知のファイルはクラッシュせず安全な画面に、削除は確認付きでゴミ箱へ、
		壊れた設定でも UI は壊れません。
	</Card>
</CardGrid>

## スクリーンショット

![git ステータス色付きのツリービュー](../../../assets/tree.png)

![自作レンダラによるコミットグラフ](../../../assets/git-graph.png)

![Markdown と Mermaid の描画](../../../assets/markdown.png)

## ドキュメント

<CardGrid>
	<LinkCard title="はじめる" description="インストール・2画面モデル・5分ツアー。" href="./getting-started/" />
	<LinkCard title="チュートリアル" description="7ステップのガイド付きツアー。ターミナルで操作しながら。" href="./tutorial/" />
	<LinkCard title="AI エージェントと働く" description="フォローモード・変更ファイルビュー・@path 参照。" href="./guides/agent-watch/" />
	<LinkCard title="プレビューを使い倒す" description="Markdown・チェックボックス・テーブル・メディア・コピー。" href="./guides/preview/" />
	<LinkCard title="git スイート" description="変更ハブ・diff・log・コミットグラフ・ブランチ。" href="./guides/git/" />
	<LinkCard title="ファイル・ブックマーク・タブ" description="絞り込み・安全なファイル操作・ブックマーク・タブ。" href="./guides/files/" />
	<LinkCard title="設定リファレンス" description="全オプション — UI・配色・プレビュールール・キー。" href="./reference/configuration/" />
	<LinkCard title="既定キーマップ" description="画面ごとのキー一覧。すべて変更可能。" href="./reference/keymap/" />
</CardGrid>

## インストール

```sh
cargo binstall konoma       # プレビルドバイナリ(要 cargo-binstall)
# または
cargo install konoma        # ソースからビルド
```

主対象は macOS (Apple Silicon)です(Intel macOS・Linux x86_64 にもプレビルドあり)。
画像プレビューには kitty graphics 対応端末([Ghostty](https://ghostty.org) など)が
必要です。起動は:

```sh
konoma [DIR]
```

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