DotBGE

bgeコマンドラインツール

bgeはDotBGEの端末向けツールです。オープンな .bge 形式を使用し、アイデンティティ暗号化にRSA-4096-OAEP、ファイル内容にAES-256-GCMを使います。アカウントやサーバーは不要です。.bgeファイルと .bgekey カードをiPhone、iPad、Androidアプリと交換できます。

インストール

macOS:Homebrewでインストールします。ユニバーサルバイナリはApple SiliconとIntelに対応し、開発者署名と公証済みです。リリースページから .pkg または単独の .zip もダウンロードできます。

brew install --cask dotbge/tap/bge

Linux:リリースページから対応するアーキテクチャ(x86_64またはaarch64)のアーカイブを取得します。Swiftランタイムは静的リンクされており、最近のglibcベースのディストリビューションでSwiftを別途インストールせずに実行できます。

tar xzf bge-<version>-linux-x86_64.tar.gz
sudo install bge-<version>-linux-x86_64/bge /usr/local/bin/bge
bge --version

shasum -a 256 -c SHA256SUMS(macOS)または sha256sum -c SHA256SUMS-linux(Linux)でダウンロードを検証します。

GitHubとリリースを見る ↗

クイックスタート

鍵ペアを作成し、受信者向けに暗号化して、対応する秘密鍵で復号します。alice.pemは秘密鍵なので安全に保管してください。bge -h または bge <command> -h でオプションを確認できます。enc / dec は encrypt / decrypt の別名です。

bge keygen -o alice
bge encrypt report.pdf -r alice.pub.pem
bge decrypt report.pdf.bge -k alice.pem

よく使う操作

既存ファイルは初期設定では上書きされません。上書きが必要なときだけ -f を使用してください。

相手宛てにファイルを暗号化

相手の .pem 公開鍵、.bgekey カード、または保存済みの連絡先名が必要です。相手の秘密鍵だけが復号できます。

bge encrypt report.pdf -r alice.pub.pem

名前で連絡先に暗号化

公開鍵を保存して名前で暗号化します。アドレス帳 ~/.bge には公開鍵だけを保存し、名前の大文字・小文字は区別しません。

bge contact add alice.pub.pem -n Alice
bge encrypt report.pdf -r Alice

自分用のバックアップを暗号化

受信者を指定しない場合は自分の有効なアイデンティティ宛てに暗号化します。

bge identity add me.pub.pem -n Me
bge encrypt taxes.pdf

パスワードで暗号化

事前に鍵を交換できない場合に便利です。パスワードを知る人が開けます。

bge encrypt report.pdf -p

.bgeファイルを復号

暗号化方式に応じて秘密鍵またはパスワードを使用します。パスワード方式では入力が求められます。

bge decrypt report.pdf.bge -k alice.pem
bge decrypt report.pdf.bge -p

ファイルの受信者を確認

公開ヘッダーのみを読み、鍵は不要です。受信者がアドレス帳にあれば名前も表示します。

bge inspect report.pdf.bge

フォルダ全体を暗号化

フォルダ構造を維持して個別に暗号化するか、ファイル名も隠す一つの暗号化アーカイブを作成します。

bge encrypt myfolder -r Alice
bge encrypt myfolder -a -r Alice

複数ファイルをまとめて暗号化

-a で複数ファイルを圧縮・暗号化します。復号時は -x で展開できます。

bge encrypt a.pdf notes.txt photo.jpg -a -r Alice -o bundle.bge
bge decrypt bundle.bge -k alice.pem -x

復号出力ファイルを作らずにデータを処理

- で標準入出力に渡します。この例は出力ファイルを作らず復号後のバイト数を数え、状態をstderrに出力します。後続プログラムがディスクに書き込む場合はあります。

bge decrypt - -k alice.pem < report.pdf.bge | wc -c

スクリプトで非対話実行

対話を避けるにはRSA鍵を優先します。パスワードは --password-stdin で渡し、コマンド引数に含めないでください。終了コードは64(使い方)、65(データ)、66(入力なし)、77(復号不可)です。

printf %s "$PASSPHRASE" | bge encrypt notes.txt --password-stdin

自分の公開鍵を共有

公開鍵を .bgekey カードにしてアプリに連絡先として読み込みます。秘密鍵を読み取る必要はありません。

bge card alice.pub.pem -n "Alice"

AIエージェントとの利用

bgeリポジトリにはClaude Codeのskillが付属し、シェルを実行できるエージェントも同じコマンドを利用できます。使用方法と保護策はAIエージェントのページをご覧ください。

AIエージェント ↗

オープン形式と鍵

CLIはファイル形式の鍵のみを使用し、秘密鍵を保存しません。アプリと同じオープンな .bge v3 を使い、仕様とテストベクトルは公開されています。

GitHubとリリースを見る ↗ · .bge ↗