MiniMax で始める、読んで育てる Neovim 設定

この記事は Vim駅伝 2026-05-27 担当分の記事です。

Vim駅伝は常に参加者を募集しています。詳しくはこちらのページをご覧ください。

MiniMax とは

GitHub - nvim-mini/MiniMax: Neovim config examples based on MINI

Neovim config examples based on MINI. Contribute to nvim-mini/MiniMax development by creating an account on GitHub.

github.com

Neovim config examples based on MINI. Contribute to nvim-mini/MiniMax development by creating an account on GitHub.

Mini と Max という対義語を並べた名前、なんかいいですよね。

MiniMax と聞くと LLM を思い浮かべる方もいるかもしれませんが、この記事で扱う MiniMax は、mini.nvim をベースとした Neovim の設定ジェネレーターを指します。

LazyVim や AstroNvim、NvChad といった、いわゆる Neovim ディストリビューションとは異なる立ち位置のプロジェクトで、生成された設定を読み、自分で育てていくような使い方が想定されています。

似たようなプロジェクトとしては、kickstart.nvim があります。

この記事では、Vim/Neovim の基本操作そのものは詳しく扱わず、MiniMax が生成する設定を読みながら Neovim 設定に入門することを目指します。

MiniMax の始め方

Neovim のインストール

何はともあれ Neovim をインストールします。執筆時点での stable は 0.12.2 です。

Install

hyperextensible Vim-based text editor

neovim.io

/rehype-og-card/d6cc3722579f9f589c129a1a661cc4aaa7bb46265c4fc827a734ca7612c96b40.png

MiniMax プロジェクトのクローン

MiniMax プロジェクトをクローンします。

# git clone の場合
git clone --filter=blob:none https://github.com/nvim-mini/MiniMax ./MiniMax

# ghq の場合
ghq get --partial blobless https://github.com/nvim-mini/MiniMax

セットアップ

NVIM_APPNAME=foo を指定すると、通常の $XDG_CONFIG_HOME/nvim ではなく $XDG_CONFIG_HOME/foo を見に行きます。

既存の Neovim 設定を変更しなくて済むので、気軽に試してみてください。

MiniMax は Neovim のバージョンに合わせて適切な設定を生成してくれます。

# git clone した場合
NVIM_APPNAME=nvim-minimax nvim -l ./MiniMax/setup.lua

# ghq の場合
NVIM_APPNAME=nvim-minimax nvim -l "$(ghq list -p nvim-mini/MiniMax)/setup.lua"

設定が生成できたら、NVIM_APPNAME を付けて起動します。

NVIM_APPNAME=nvim-minimax nvim

初回起動時には、プラグインのインストール確認が表示されるので y を押します。

通知が落ち着くまで待てばセットアップ完了です。

MiniMax の構成

生成された設定の中身を見てみましょう。~/.config/nvim-minimax/ は次のような構成になっています。

※ 以下は Neovim 0.12 の場合の構成です。

~/.config/nvim-minimax/
├── init.lua              -- 最初に実行されるファイル
├── nvim-pack-lock.json   -- vim.pack のロックファイル
├── plugin/
│   ├── 10_options.lua    -- vim.opt 系の基本オプション
│   ├── 20_keymaps.lua    -- Leader キー周りとマッピング
│   ├── 30_mini.lua       -- mini.* モジュールのセットアップ
│   └── 40_plugins.lua    -- mini 以外のプラグイン定義
├── snippets/
└── after/

vim.pack について

Neovim 0.12 では、vim.pack というビルトインのプラグインマネージャーが追加されました。

MiniMax では、vim.pack の実践的な設定を知ることができるため、すでに Neovim をお使いの方にも参考になるかと思います。

vim.pack を実装したのは、mini.nvim や MiniMax の作者である Evgeni Chasnovski 氏です。

vim.pack は、同氏が開発していた mini.deps の設計を土台にしつつ、Neovim 本体に組み込むために、よりシンプルで保守しやすい形へ再設計されています。

プラグイン管理は vim.pack.add() を中心とした最小限の API にまとまっており、mini.deps で得られた知見を踏まえ、手動のスナップショットではなく、自動生成されるロックファイル(nvim-pack-lock.json)が採用されています。

詳しくは作者による vim.pack ガイドをご覧ください。

A Guide to vim.pack (Neovim built-in plugin manager) – Evgeni Chasnovski

A somewhat concise yet comprehensive guide to vim.pack: how it works and how to use it

echasnovski.com

/rehype-og-card/ae44dc393dbbdcc3dc600809063bfe3f796ec658303424f0f67d8433b5db7537.png

読む

Neovim を起動すると mini.starter による起動画面が表示されます。

ここから各設定ファイルを読んでいきましょう。まずは入口となる init.lua を開くために以下を入力します。

<Space> + e + i

<Space> は Leader キーに設定されています。押すと、次に押せるキーの候補を右下に表示してくれる mini.clue が起動します。詳しくは、plugin/10_options.lua や plugin/20_keymaps.lua に設定されているので後で読んでみましょう。

英語が不得手な方は、AI を活用して読んでもらうか、手前味噌ですが、fork して README や設定ファイルのコメントを日本語に翻訳したブランチがあるので、こちらを見てもらえるとよいかもしれません。

GitHub - kmkkiii/MiniMax at feature/japanese-localization

Neovim config examples based on MINI. Contribute to kmkkiii/MiniMax development by creating an account on GitHub.

github.com

Neovim config examples based on MINI. Contribute to kmkkiii/MiniMax development by creating an account on GitHub.

init.lua

mini.nvim という設定のコアとなるプラグインをここで読み込んでいます。

mini.nvim はオールインワンのプラグインで、この設定で有効化されているモジュールだけでも 30 を超える様々な便利機能が使える優れものです。

あわせて、Config.now() / Config.later() といった「いつ読み込むか」を制御するヘルパーもここで定義しています。 (lazy.nvim の event / ft のような)トリガー起点で読みたい場合は Config.on_event() / Config.on_filetype() が用意されています。

各機能の実体は plugin/ 以下に分かれているので、init.lua 自体は薄くなっています。

plugin

設定の本体はここに集まっています。

一般的な Neovim 設定では lua/ 配下に設定を分けることも多いですが、MiniMax では Neovim が plugin/ 配下を辞書順に自動読み込みすることを活用して、init.lua を薄く保っています。

これによって、Lua の名前空間を占有せず、require() も不要になる点がメリットとして挙げられています。

10_options.lua
- vim.opt 系の基本オプションと Leader キー(<Space>)の設定
20_keymaps.lua
- <Leader>f=検索 / g=Git / l=LSP のようにグループ分けされたキーマップ
- mini.clue のガイド表示とも連携
30_mini.lua
- MiniMax の主役。30 を超える mini.* モジュールをセットアップ
40_plugins.lua
- mini 以外(nvim-treesitter・nvim-lspconfig・conform.nvim・friendly-snippets)を vim.pack.add() で追加

<Space> を押して f / g / l を辿ると、20_keymaps.lua で定義したキーマップが実際の動作として確認できます。

snippets

snippets/ は mini.snippets が読みに行くディレクトリで、VSCode 形式の JSON でスニペットを定義します。

MiniMax の global.json には日付・時刻を挿入するスニペットが入っており、friendly-snippets と組み合わせて使われます。

自分用のスニペットを足したくなったときの入口になっています。

after

after/ は Neovim 標準の仕組みで、設定の最後に読み込まれます。

MiniMax では主に次のファイルが置かれています。

after/lsp/lua_ls.lua
- Neovim 0.12 の vim.lsp.config 方式による言語サーバーの個別設定。サーバーごとにファイルを分けられます
after/ftplugin/markdown.lua
- ファイルタイプ別の設定
after/snippets/lua.json
- 言語別のスニペット