CLI リファレンス

magiclock のすべてのサブコマンドとフラグを、一箇所にまとめました。

すべては 1 つのコマンドに集約されています：magiclock <subcommand> [options]。magiclock --version はインストール済みのバージョンを表示し、引数なしの magiclock はヘルプを表示します。

activate

このマシンの認証とプロビジョニングを行います。冪等であり、再実行しても安全です。

フラグ意味
--server URLライセンスサーバーの URL（保存済みセッション、次に $MAGICLOCK_SERVER にフォールバック）。
--token TOKENBearer トークン（保存済みセッション、次に $MAGICLOCK_TOKEN にフォールバック）。
--with-tokenヘッドレスモード：$MAGICLOCK_TOKEN または標準入力からポータル発行のトークンを読み取ります。
--no-browserサインインが必要な場合、ブラウザを開く代わりにリンクとコードを表示します。

status

このマシンのアカウントと有効化状態を表示します。

フラグ意味
--offlineサーバーへの通信をスキップし、ローカルの状態のみから報告します。

protect

.py ファイル（またはディレクトリを再帰的に）を、ゲートで保護された .pya に暗号化します。

shell
magiclock protect PATH [-o OUT] [--remove]
                  [--trial | --expires-in DURATION | --expires-at DATE]
                  [--lock-passphrase | --no-bind-machine [--passphrase | --emit-key]]
フラグ意味
PATH保護対象の .py ファイル、または再帰的に保護するディレクトリ（.venv、venv、__pycache__、.git、dist、build は自動的にスキップされます）。
-o, --out出力パス（ディレクトリの場合は出力先のルート）。
--remove暗号化後に平文の .py ファイルを削除します。
--trial固定 48 時間の自己消去 — デモ用。
--expires-in DURATION指定した期間の経過後、復号を停止します（例：30d）。
--expires-at DATE指定した日付以降、復号を停止します（例：2026-12-31）。
--lock-passphrase二要素ロック：このマシンおよびパスフレーズ。
--no-bind-machineポータブル形式の成果物 — マシンロックなし。
--passphrase--no-bind-machine と併用：パスフレーズで解錠（$MAGICLOCK_PASSPHRASE、またはプロンプト）。
--emit-key--no-bind-machine と併用：パスフレーズの代わりに、帯域外配布用の生成済みキーを表示します。

--trial/--expires-in/--expires-at は互いに排他的です。--lock-passphrase は --no-bind-machine 系のグループと排他的です。

protect-model

モデルまたはその他のリソースを .enc エンベロープへ暗号化します。protect と同じ有効期限系フラグ、--lock-passphrase、ポータブル系フラグに加えて、以下を取ります。

フラグデフォルト意味
PATH—暗号化するファイル。
-o, --out<path>.enc出力パス。
--feature NAMEai_modelこの成果物を解錠するために必要なライセンスケーパビリティ。
--removeoff暗号化後に平文ファイルを削除します。

build

アプリをネイティブバイナリへコンパイルし、ライセンスゲートをすべてのモジュールへ自動で組み込みます。詳しい手順はコンパイルビルドを参照してください。

フラグデフォルト意味
entry—エントリーポイントとなる .py ファイル。
-o, --output-dirdistビルド出力ディレクトリ。
--source-rootエントリーファイル走査・変換対象のプロジェクトルート。
--moduleon単一ファイルのネイティブ拡張としてコンパイル。
--standalone—単一モジュールの代わりに、自己完結型のアプリディレクトリとしてコンパイル。--module とは排他的。
--no-compileoff走査・注入・埋め込みのみを行い、ネイティブコンパイルはスキップ。
--keep-tmpoff変換用の中間ディレクトリを保持。
--model PATHnoneモデルを暗号化してバンドル（複数回指定可能）。
--model-lock-passphraseoffバンドルしたモデルの二要素ロック（--model を 1 つ以上指定している必要あり）。
--model-trial / --model-expires-in / --model-expires-atnoneバンドルしたモデルの有効期限 — 互いに排他的。

run

.py または .pya を、ゲートを含めて実行します。

フラグデフォルト意味
entry—実行するファイル。
--app-version1.0.0アプリのバージョン。ライセンスが設定する max_app_version と照合されます。
--passphraseoff復号用のパスフレーズをプロンプトで入力（または $MAGICLOCK_PASSPHRASE を読み取り）— ポータブルまたは二要素の成果物向け。
--key KEY—ポータブル成果物の復号キー（base64）、または $MAGICLOCK_DECRYPT_KEY を読み取り。

deactivate

このマシンをあなたのアカウントから削除します。

フラグ意味
--local-onlyサーバー上のシート解放や失効を行わずに、ローカルのボルトのみをクリアします。
--server URL解放リクエスト用のサーバー URL。
--token TOKEN解放リクエスト用の Bearer トークン。

completion

シェルのタブ補完スクリプトを表示します。

shell
magiclock completion bash > /etc/bash_completion.d/magiclock
magiclock completion zsh  > "${fpath[1]}/_magiclock"
前へアカウントと有効化次へPython API リファレンス