よくある質問

progLens についてよく聞かれることをまとめました。画面の使い方は「機能」の各ページ、解説ファイルの形は「解説ファイル」のページにあります。

progLens はどこで手に入りますか

macOS（Apple Silicon）向けの .app を配っています。Homebrew なら brew install --cask takushio2525/proglens/proglens の 1 行で入り、配布のページ（GitHub Releases）から zip を落として置くこともできます。コード署名をしていないので、初めて開く前に隔離の印を外します（入れ方と更新）。

Windows やスマホで使えますか

今は macOS（Apple Silicon）だけです。OS ごとの処理を 1 か所に閉じ込め、狭い幅で 1 列に畳める画面にしてあるので、Windows 版とスマホ版は同じ画面のまま順に作ります。スマホ版は Mac の progLens に遠隔でつなぐ端末になる予定です。

どの言語のプロジェクトを読めますか

土台の汎用版が、C・C++・Dart・Go・JavaScript・Python・Rust・Swift・TypeScript の関数やクラスの輪郭を読み、どの言語でも網羅率と古さを出します。TypeScript・React・Next.js と Rust は、型の辺やクレートの依存まで追う強化の層が効きます。

tako が無いと使えませんか

解説がすでにあるプロジェクトを開いて読む・コードを追う・網羅率を見る・視点や学びの道筋をたどるのは、tako が無くてもできます。チャット・レビューの返事・AI に解説を埋めてもらうのは、裏で答える AI が tako の master なので、tako とつながっているときだけ使えます。

コードはどこかに送られますか

progLens は、利用状況やコードをどこにも送りません。外と通信するのは、アプリの更新の確認（GitHub に新しい版を問い合わせる）だけです。AI に頼んだときは、tako の master（Claude Code）が手元のファイルを読み、Claude Code の仕組みで AI に送ります。

解説ファイルは git に入れてよいですか

内置きなら、proglens.yaml と .proglens/ のノート・ツアー・旅・視点・学びの道筋は git に入れて共有できます。.proglens/cache/（機械の索引）と .proglens/local/（レビュー・理解の印などの自分だけのもの）は入れません。置き場を作るときに .gitignore へ 2 行足します。

公開のリポジトリを読んでも大丈夫ですか

外置きにすれば、対象のリポジトリには何も書きません。解説にはコードの引用が入るので、公開のリポジトリの中には置かないでください。公開のリポジトリを開くと、progLens は外置きを勧めます。

解説を自分で書けますか

解説ファイルを書くのは progLens の書き込み層だけで、AI は MCP の道具から書きます。人はアプリで、確認済みの印・理解の印・質問を付けます。テキストのファイルを手で直接書き換えると、ほかの人や AI の変更を上書きするおそれがあるので、Claude Code のガードが直接の編集を止めます。

コードを書き換えたら解説はどうなりますか

解説は書いたときのコードの指紋を持っているので、中身が変わると「古い」の印が付きます。整形し直しただけでは古くなりません。古い解説は AI に直してもらい、人は差分を見て確認済みにします。