---
title: はじめる
description: インストール・2画面モデル・5分ツアー。
---

## インストール

```sh
cargo binstall konoma        # プレビルドバイナリ(cargo-binstall は Homebrew で導入)
# または
cargo install konoma         # Rust ツールチェーンでソースからビルド
```

cargo を使わない場合は
[GitHub のリリースページ](https://github.com/LESIM-Co-Ltd/konoma/releases)から
tarball を直接ダウンロードできます。

**動作要件**

- 主対象は macOS (Apple Silicon)。Intel macOS も動作し、Linux x86_64 は
  実験的サポート。Windows は非対応です。
- 画像 / SVG / 動画サムネイル / PDF のプレビューには **kitty graphics
  プロトコル**対応端末([Ghostty](https://ghostty.org) か kitty)が必要です。
  テキスト系プレビューはどの端末でも動きます。
- アイコンには Nerd Font グリフが必要: 端末のフォールバックフォントに
  `Symbols Nerd Font Mono` を足すか、NF 内蔵フォント(HackGen Console NF・
  UDEV Gothic NF など)を使ってください。無い場合は設定で `ui.icons = false`
  にすればプレーン記号で動きます。

任意ツール(無くてもその機能以外は動作): `git`(git スイート)・`poppler`
(PDF の複数ページ)・`ffmpegthumbnailer`/`ffmpeg`(動画サムネイル)・
`lazygit`(`O` の外部 git ツール)。

## 2画面モデル

```sh
konoma            # カレントディレクトリを開く
konoma ~/work     # 任意のディレクトリ
```

konoma のメイン画面は2つだけで、分割ペインはありません:

1. **ツリー** — 全画面のファイルツリー。`j`/`k` で移動、`l` か `Enter` で
   展開/潜行、`h` で親へ。
2. **プレビュー** — 選んだファイルの全画面表示。`q`(または `Esc`)でツリーへ。

git ビューやブックマーク一覧・ヘルプは、この2画面の上に重なります。
覚えるべき習慣は2つ:

- **`?` = いま見ている画面のヘルプ。** すべてのビューが自分のキーを説明します。
- **`q` = 一段戻る。** `Q` はどこからでも終了(確認付き)。

## 5分ツアー

1. プロジェクトのディレクトリで `konoma` を起動。
2. `/` を押して数文字入力 — ツリーが絞り込まれます。`Esc` で解除。
3. Markdown ファイルを選んで `Enter` — 見出しや表つきで描画されます。
   `Tab` でリンクをフォーカス、`Enter` で辿り、`q` で戻る。
4. 画像や PDF を選ぶ — 実ピクセルの全画面表示。`+`/`-` でズーム、
   PDF は `J`/`K` でページ送り。
5. git リポジトリ内で `o` — 変更ハブが開きます。ファイル上の `Enter` で
   全画面 diff、`l` で log、`g` でコミットグラフ。`q` で戻る。
6. `m` → `a` で現在地をブックマーク。`'` で一覧が開き、英字キーでジャンプ。

## 組み込みチュートリアル

リポジトリには **konoma 自身で読む**ハンズオンツアーが同梱されています —
実際に辿れるリンクと、実際にトグルできるチェックボックス付きです:

```sh
git clone https://github.com/LESIM-Co-Ltd/konoma
konoma konoma/samples        # tutorial.ja.md を開く
```

## 次に読む

- [チュートリアル](../tutorial/) — 7ステップのガイド付きツアー。
- [AI エージェントと働く](../guides/agent-watch/) — konoma の看板ワークフロー。
- [プレビューを使い倒す](../guides/preview/) — Markdown・テーブル・メディア・コピー。
- [git スイート](../guides/git/) — ハブ・diff・log・グラフ・ブランチ。
- [ファイル・ブックマーク・タブ](../guides/files/) — ファイルマネージャとしての顔。
- [設定リファレンス](../reference/configuration/) — 全オプションを1ページで。
