Giteasy

GitEasy

Git の専門用語を知らなくても、作業内容を保存して公開できる PowerShell モジュールです。

Keith より

Keith Ramsey です。仕事では SQL Server のデータベース管理者をしており、余暇には PowerShell に熱中しています。この 13 年間、同じチームで働きながら、私たち特有の悩みを解決する社内ツールをひっそりと作ってきました。GitEasy は私にとって新たな一歩です。一般公開するのはこれが初めてのツールです。知らない人のために設計すること、つまりコードを磨き、役に立つよう平易な言葉で書くことは、正直なところ、本当に楽しい経験でした。

このモジュールを見てくださっている方に、気に入ってもらえたらいいなと思うだけではありません。ほっとしてもらえたらと願っています。正直に言うと、以前は Git が怖かったんです。コミットを失敗させて、いら立ちながらデスクを離れ、「明日になったら解決しよう」と自分に言い聞かせたこともあります。フルタイムの開発者が Git を軽々と使いこなす一方で、私は DBA、コンプライアンスチーム、変更管理担当者と一緒に働いています。私たちは、以前の TFS のチェックイン機能が戻ってきてほしいと思っている人たちです。Git は単なるツールではありません。落とし穴だらけの、新しい語彙体系そのものです。

長い間、私たちは Git を避けて何とかやってきました。しかし、ついに「Git を使うことになった。覚えるように」と指示が下りました。ファイルを保存するだけなのに、期末試験の勉強をしているような気分で座っていたとき、GitEasy のアイデアがひらめきました。専門用語を取り除けたらどうでしょう？コードをチェックインするのに、新しい語彙を丸ごと覚える必要がなかったらどうでしょう？

そこで登場するのが GitEasy です。シンプルなコマンドは 5 つだけ。分かりにくい Git の生のテキストは表示されません。操作ごとにログファイルが 1 つ作成されます。摩擦のないラッパーなので、Git を知っている方はいつでも回避できます。知らない方は、怖いものを見る必要がありません。

大切なお知らせがあります。現時点では、GitEasy の変更を行っているのは私だけです。他の人からコード変更を受け入れるための適切な法的書類を整えるには弁護士が必要です。やり直しになるかもしれない法的書類に時間とお金をかけるより、もっと役立つコードを公開することに使いたいと思っています。これは恒久的な方針ではなく、今は慎重に進めているだけです。ただし、GitEasy は MPL 2.0 のライセンスで公開されており、誰でも自由にコードを引き継いで、独自に開発を続けられますのでご安心ください。このプロジェクトの存続は私にかかっているわけではありません。

この方針にためらいを感じる方がいても、十分理解できます。私はオープンソースの世界について、一歩ずつ学んでいる一人の人間にすぎません。扉に鍵はかかっていません。ただ、今日は閉じているだけです。バグ報告や機能のアイデアはいつでも歓迎します。GitHub プロジェクトにアクセスして Issue を作成し、必要なことを教えてください。目を通します。コードを書く必要はありません。話をしたい方は、GitHub で @greenmtnsun を探してください。

Git のエラーメッセージが、保存しようとしていた変更より怖く感じて PowerShell を閉じたことがあるなら、このツールはあなたのために作られました。少しでもほっとして、楽しく使っていただけたらと思います。それでは。

メモ

Keith からの短い近況メモです。新しいものが上にあります。プロジェクトの進展に合わせて編集・追記します。

2026-05-22 — CI と AI エージェントの利用方針を専用ページにまとめました

docs/USING-IN-CI-AND-AGENTS.md を追加しました。CI パイプライン（GitHub Actions、Azure Pipelines、GitLab）や AI コーディングエージェントから GitEasy を使いたい方に向けた、単一の規約です。利用者に私自身のテストスイートの実行や、専門用語の監査を求めないよう意図的にしています。これらは私が品質基準として設けているものであり、利用者に課すものではありません。

2026-05-22 — 現時点ではコントリビューションの受付を停止しています

CLA はありません。実際に必要になるまでは、法務関連に投資するつもりはありません。Issue でのバグ報告は歓迎します。PR はレビューしません。方針が変わった場合は、このメモでお知らせします。

2026-05-21 — v1.5.3 の準備完了、PowerShell Gallery への公開は保留中

1.5.3 は機能が完成し、マニフェストの準備も整っています（アイコン、リポジトリ内の LicenseUri、リリースノートのプレーンテキスト埋め込み、対象者タグ付きキーワード 14 個）。また、ドキュメントごとの PDF を含めた .nupkg も問題なくビルドできます。リポジトリを公開するかどうか決めるまで、PSGallery への実際の公開は保留しています。最初の外部ユーザー（Tycro）は、現在プライベートリポジトリのクローンからインストールしていますが、問題なく動作しています。

2026-05-20 — セキュリティレビュー完了（v1.5.2）

1.5.1 のレビューで見逃していた類似パターンのバグに関する、認証情報の露出範囲の指摘 3 件（F-04 / F-05 / F-06）に対応しました。Tests/GitEasy.AuthHardening.Tests.ps1 にキルテスト一式を追加しました。認証情報ヘルパーと GitEasy を併用している場合は、少なくとも 1.5.2 をお使いください。

できること

簡単な英語のコマンドを少数用意しています。複雑な処理はエンジン内部に隠され、目にするものや入力するものはシンプルなままです。

Find-CodeChange         # What has changed?
Save-Work 'fix readme'  # Save and publish in one step.
Show-History            # Recent saved points.
Show-Remote             # Where this folder is published.

問題が発生すると、簡潔な英語のメッセージと、技術的な詳細を記録した自己完結型ログファイルのパスが表示されます。Git の生出力がユーザーに表示されることはありません。

インストール

手軽にインストール（PS 5.1 および PS 7、管理者権限不要）：

$Edition = if ($PSVersionTable.PSEdition -eq 'Core') { 'PowerShell' } else { 'WindowsPowerShell' }
$ModuleDir = Join-Path $HOME "Documents\$Edition\Modules\GitEasy"
git clone https://github.com/greenmtnsun/GitEasy.git $ModuleDir
Import-Module GitEasy

これにより、GitEasy はユーザースコープの PowerShell モジュールフォルダー（デフォルトで $env:PSModulePath に含まれます）に配置されるため、どこからでも Import-Module GitEasy を実行できます。オフラインでのインストール方法と全ユーザー向けスコープについては、docs/HOW-TO-USE-GITEASY.md をご覧ください。

PowerShell Gallery でリリースされた後は、次の方法でインストールできます。

Install-Module GitEasy -Scope CurrentUser

公開後の PowerShell Gallery ページは、powershellgallery.com/packages/GitEasy です。

クイックスタート

# In any folder that is already a Git repo:
Find-CodeChange
Save-Work 'first save'
Show-History -Count 5

リポジトリがまだどこにも公開されていない場合、Save-Work はそのことを知らせ、ローカルに保存します。後から公開先に接続すると、次回の Save-Work で、それまでに保存したすべての内容が公開されます。

コマンド一覧

コマンド	機能
Find-CodeChange	プロジェクトフォルダー内で変更された内容を表示します。
Save-Work	変更を保存して公開します（または -NoPush でローカルに保存します）。
Show-History	最近保存した状態を表示します。
Show-Remote	プロジェクトフォルダーの公開先を表示します。
Show-Diagnostic	診断ログファイルを開くか、一覧表示します。
New-WorkBranch	タスクを分離するための新しい作業領域を開始します。
Switch-Work	既存の別の作業領域に切り替えます。
Restore-File	単一のファイルを最後に保存した状態に戻します。
Undo-Changes	未保存の変更を破棄します（-Force または -Confirm が必要です）。
Clear-Junk	明らかな一時ファイルを一覧表示または削除します。
Test-Login	公開先への接続を確認します。
Set-Token	HTTPS ベースのログインを設定します。
Set-Ssh	SSH ベースのログインを設定します。
Set-Vault	保存済みログイン情報の保存先を選択します。
Get-VaultStatus	設定済みの認証情報ヘルパーを表示します。
Reset-Login	保存済みのログイン情報を消去し、再設定できるようにします。

各コマンドには、コメントベースのヘルプがすべて用意されています。簡潔な説明を表示するには Get-Help <Command> -Full を実行してください。

診断ログ

各公開コマンドは %LOCALAPPDATA%\GitEasy\Logs に小さなログファイルを書き込みます。正常に実行された場合、ログは通知なしで記録されます。失敗した場合は、簡潔な英語のメッセージを表示し、Git に詳しい人が状況を確認できるようログのパスを伝えます。

Show-Diagnostic           # Open the most recent log.
Show-Diagnostic -List     # List recent logs.
Show-Diagnostic -All      # Open the logs folder.

30 日を超えたログは自動的に削除されます。

ドキュメント

詳しいドキュメントは GitHub Wiki にあります。各公開コマンドのページには、概要、使用例、安全上の注意、関連コマンドへの相互参照が記載されています。保守担当者向けに、各非公開ヘルパーについても同様のページを用意しています。

互換性

• Windows PowerShell 5.1+
• PowerShell 7+（Windows。クロスプラットフォームでも動作する可能性はありますが、設計上の対象ではありません）
• Git がインストールされ、PATH に含まれている必要があります。

CI ジョブや AI エージェントから GitEasy を実行しますか？利用者向けの1ページの仕様書 docs/USING-IN-CI-AND-AGENTS.md をご覧ください。

ステータス

GitEasy は 1.5.3 です。公開インターフェースの機能は一通り実装済み（21個のコマンド）で、両方の PowerShell ホストで569件の Pester テストを実施しており、平易な英語による仕様書も完備しています。

これまでの変更履歴は CHANGELOG.md をご覧ください。

貢献

GitEasy は単独の作者が保守しており、現在、外部からのプルリクエストは受け付けていません。コントリビューター契約が整備されていないためです。Issue としてのバグ報告は歓迎します。

作者の品質基準（テストの徹底、専門用語を使わない方針、診断ログを使ったセッションのパターン）は、透明性を確保するため CONTRIBUTING.md に記載されています。

ライセンス

Mozilla Public License 2.0。ファイル単位のコピーレフトです。誰でもこのコードを利用、改変、プロプライエタリまたはオープンなプロジェクトへの組み込みができます。ただし、GitEasy 自身のファイルに対する改変は MPL-2.0 の下で公開する必要があります。

作者

Keith Ramsey（@greenmtnsun）。