mcpField
K
knbox

knbox

github.com/summic生産性151 回インストール18 週間前に更新
リポジトリ

knbox について

KN Box Skillは、knboxコマンドラインでファイルをプレビューまたは共有用にアップロードする手順をエージェントに示します。アクセス確認、ファイル操作、保存先、競合処理を扱い、機密情報のアップロードを禁止します。

主な機能

  1. 01knboxでファイルやディレクトリをアップロード
  2. 02アップロード前のアカウント確認
  3. 03リモートファイルの一覧表示とオープン
  4. 04リモートの保存先を指定
  5. 05名前変更または許可済み上書きで競合に対応

活用シーン

  1. 01公開URLでファイルを共有
  2. 02プレビュー用にディレクトリをアップロード
  3. 03アップロード済みファイルやディレクトリを閲覧

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/summic/knbox-skills --skill knbox

インストール後、Claude Code で/knboxを入力して読み込まれたか確認します。

詳細

KN Box スキル

プレビューや共有のためにファイルをアップロードする必要がある場合は、KN Box を使用します。

要件

  • アップロードには knbox CLI のみを使用します。
  • 利用可能な場合は、KNBOX_TOKEN を使った非対話型認証を優先します。
  • デフォルトのサーバーは https://box.kn.run です。
  • 機密情報をアップロードしないでください。

アクセスの確認

アップロードする前に、CLI から KN Box に接続できることを確認します。

knbox auth whoami --json

ユーザーがログインしていないために失敗した場合は、次を実行するようユーザーに依頼します。

knbox auth login

非対話型環境では、KN Box CLI トークンをユーザーに尋ね、次を設定します。

export KNBOX_TOKEN=knbox_xxx

デフォルトのサーバーはすでに https://box.kn.run です。ユーザーが別の KN Box サーバーを明示的に希望する場合にのみ、KNBOX_URL を設定します。

ファイルのアップロード

ファイルまたはディレクトリをアップロードします。

knbox upload <file-or-dir> --json

特定のリモートディレクトリにアップロードします。

knbox upload <file-or-dir> --to /agent-output --json

返された JSON を読み取ります。

  • data.entryUrl は、Web ページ用ディレクトリに表示する URL として最適です。
  • data.uploaded[].url には、個々のファイルの URL が含まれます。
  • summary は、人が読みやすい簡潔な結果です。
  • breadcrumbs には、後続の操作に役立つコマンドが含まれます。

ナビゲーション

ファイルを一覧表示します。

knbox ls [path] --json

保存済みのリモートディレクトリを変更します。

knbox cd <path>

ファイルまたはディレクトリを開きます。

knbox open <path> --json

ファイルの場合、open は公開 URL を返します。ディレクトリの場合は、ディレクトリの一覧を返します。

競合の処理

デフォルトでは、競合があるとアップロードは失敗します。

別個のコピーを作成しても問題ない場合にのみ、--rename を使用します。

knbox upload <path> --rename --json

既存のファイルを置き換えることをユーザーが明示的に希望する場合にのみ、--overwrite を使用します。

knbox upload <path> --overwrite --json

失敗時の処理

knbox がゼロ以外の終了コードを返した場合は、標準エラー出力を確認して失敗を報告します。ファイルがアップロードされたと判断しないでください。

コメント

Markdown 対応