---
title: チュートリアル
description: 7ステップの konoma ツアー — ターミナルで実際に操作しながら読んでください。
sidebar:
  order: 2
---

これは「読みながら試す」ツアーです。konoma をターミナルで開いたまま、各ステップを
実際に操作してください。覚えるキーは2つ — **`?` = いまの画面のヘルプ、`q` = 一段戻る。**

:::tip[konoma の中で読むのがおすすめ]
このツアーの*インタラクティブ版*がリポジトリに同梱されています —
[`samples/tutorial.ja.md`](https://github.com/LESIM-Co-Ltd/konoma/blob/main/samples/tutorial.ja.md)
— 実際に辿れるリンクと、実際にトグルできるチェックボックス付きです:

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

## 1. スクロールと行き来

適当なディレクトリを開き(`konoma ~/some/project`)、テキストファイルを選んで
`Enter`。`j`/`k` でスクロール(半ページ: `Ctrl-d`/`Ctrl-u`、先頭/末尾: `g`/`G`)、
`q` でツリーへ戻ります。この「全画面ツリー ⇄ 全画面プレビュー」の往復が konoma の
中核です。分割ペインはありません。

## 2. Tab でリンクを辿る

リンクのある Markdown を開いて `Tab` を何度か押すと、フォーカス(反転表示)が文書内の
リンクとチェックボックスを順に巡回します。`Enter` で開く — ローカルパスは konoma 内で
(`q` で戻れます)、URL はブラウザで開きます。

## 3. チェックボックスを切り替える

タスクリスト(`- [ ]`)のある Markdown で、`Tab` でチェックボックスへ → `Space`。
表示が切り替わり、**状態がファイルに書き戻されます** — 書込み前にディスク上の
ファイルと照合するので、並行して編集中のエージェントを壊しません。`R` で生ソースを
見れば変更を確認できます。

## 4. 検索とコピー

- `/` でプレビュー内検索、`n`/`N` で一致間を移動。
- コード/テキスト(と raw Markdown)ではキャレットを `h j k l` で動かし、
  `v`(文字単位) / `V`(行単位)で選択して `y` でコピー。
- `Y` は `@path#L12-34` 参照をコピー — AI エージェントとの会話に貼れば行単位で
  場所が伝わります。
- ツリーの `y` はコピーメニュー: 名前・相対/フルパス・親・`@相対パス` 参照。

## 5. ツリーはファイルマネージャ

- `/` で入力しながら絞り込み、`Esc` で解除。
- `Space` でファイル管理メニュー: 作成 `n`・リネーム `r`・削除 `d`(確認の後、
  ゴミ箱へ)・コピー/カット/ペースト `c`/`x`/`p`。
- `.` で隠しファイル、`s` でソート、`i` でファイル情報。
- `m` + 英字でカーソル位置をブックマーク(小文字=このプロジェクト・大文字=グローバル)、
  `'` で一覧 — 英字キーでジャンプ。どちらも**プレビュー中でも使え**、その場合は
  表示中のファイルが対象になります。

## 6. Git をその場で

git リポジトリ内で: `o` が変更ハブ(`s` で stage・`c` でコミット)、ファイル上の
`Enter` で全画面 diff(`s` で unified/split 切替)、`l` が log、`g` がコミット
グラフ — グラフ内でコミットに `s` を押すと、そのブランチがレーン0の直線に固定
されます。変更ファイルはツリーで色付き、コードプレビューには変更ガター。

## 7. AI エージェントの作業を眺める

看板ワークフロー — 左に konoma、右にコーディングエージェント:

- `F` で**フォローモード**: エージェントが変更したファイルが自動で diff 表示
  されます。任意のキーで手動に戻り、`F` で再開。
- diff 表示中の `n`/`N` は、この追尾セッションで変わったファイルを巡回。
- `C` で未コミット変更の一覧。`y` → `@` と `Y` で会話に貼る参照をコピー。

さらに詳しく: [AI エージェントと働く](../guides/agent-watch/) ·
[プレビュー](../guides/preview/) · [Git](../guides/git/) ·
[ファイルとブックマーク](../guides/files/) ·
[設定リファレンス](../reference/configuration/)
