Qiita CLI previewを開いた時にエラーになる

[fussy113]

ローカル環境でQiita CLIのプレビュー環境を立ち上げた時に、以下エラーが発生したので共有になります。

• MacOS 15.7.1(Apple M3)
• node.js 24.8.0
• Browser: Chrome 142.0.7444.162

stacktrace

> "Preview: http://[::1]:8888
node:internal/fs/watchers:214
      const error = new UVException({
                    ^

Error: EMFILE: too many open files, watch
    at FSWatcher._handle.onchange (node:internal/fs/watchers:214:21)
Emitted 'error' event on FSWatcher instance at:
    at FSWatcher._handleError 
(qiita-articles/node_modules/.pnpm/chokidar@4.0.3/node_modules/chokidar/index.js:539:18)
    at NodeFsHandler._boundHandleError 
(qiita-articles/node_modules/.pnpm/chokidar@4.0.3/node_modules/chokidar/handler.js:300:49)
    at qiita-articles/node_modules/.pnpm/chokidar@4.0.3/node_modules/chokidar/handler.js:149:9
    at foreach (qiita-articles/node_modules/.pnpm/chokidar@4.0.3/node_modules/chokidar/handler.js:81:9)
    at fsWatchBroadcast 
(qiita-articles/node_modules/.pnpm/chokidar@4.0.3/node_modules/chokidar/handler.js:148:5)
    at FSWatcher.<anonymous> 
(qiita-articles/node_modules/.pnpm/chokidar@4.0.3/node_modules/chokidar/handler.js:196:17)
    at FSWatcher.emit (node:events:508:28)
    at FSWatcher._handle.onchange (node:internal/fs/watchers:220:12) {
  errno: -24,
  syscall: 'watch',
  code: 'EMFILE',
  filename: null
}

要因としては、 node_modules 配下も含む大量のファイルについて監視対象に入ってしまっていることで、Macのファイルディスクリプタが枯渇したためと考えています。

https://github.com/increments/qiita-cli/blob/main/src/commands/preview.ts#L26

https://github.com/increments/qiita-cli/blob/b74c2a3e5ab376d61cd91642fa3734ef20df1b26/src/lib/config.ts#L145-L147

QIITA_CLI_ITEMS_ROOT を環境変数として設定していると、監視対象が環境変数で設定されたディレクトリ配下になるので、回避は出来ることは確認しています。
ただ監視対象として、記事を格納しているディレクトリのみにするか、node_modulesなど不要なディレクトリは監視対象からignoreすることを検討いただきたいです。

increments/qiita-cli#339 で修正を検討しています。
よろしくお願いします！

[acronhub]

@fussy113
エラーの共有と、修正のプルリクエスト作成まで、ありがとうございます！✨

内容を確認させていただき、レビューいたします。
マージまで少しお時間をいただくかもしれませんが、よろしくお願いします🙇