npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@gameagelayer/yobitsugi

v0.6.0

Published

YOBITSUGI AI をターミナルから使う(yobitsugi コマンド)

Readme

yobitsugi-cli

YOBITSUGI AI をターミナルから使う(yobitsugi コマンド)

AI への依頼をターミナルから送り、結果を受け取れます。ローカルのファイルを添付したり、AI が作成したファイルをダウンロードしたりできます。あなたの許可を得て、AI が手元のフォルダのファイルを読み書きしたり、コマンドを実行したりすることもできます。

詳しい使い方は、ターミナルから使う(CLI)をご覧ください。

インストール

npm install -g @gameagelayer/yobitsugi

Node.js 20 以上が必要です(手元のフォルダで作業する機能は Node.js 22 以上)。

ログイン

yobitsugi login

ブラウザで YOBITSUGI AI のログイン画面が開きます。ログインして「ログインする」を押すと完了です。アカウントをお持ちでない場合は、YOBITSUGI AI から登録できます。

ブラウザが開かない場合や、SSH で接続した先など別のコンピューターでログインする場合は、ターミナルに表示される URL を手元のブラウザで開いてください。ログインして「ログインする」を押すとコードが表示されるので、ターミナルに貼り付けると完了です(yobitsugi login --no-browser では、ブラウザを開かずに URL だけを表示します)。

サーバーなどに管理者が設定する場合は、管理者から受け取った鍵でログインできます(ブラウザは使いません)。次のコマンドを実行し、鍵を貼り付けてください。鍵は 1 回だけ使えます。

yobitsugi login --token -

使い方

yobitsugi                                          # 対話モードを開始
yobitsugi "この表を集計して"                          # 最初のメッセージを指定して対話モードを開始
yobitsugi -p "@売上.csv を集計してグラフにして" -o out   # 1 回だけ実行し、作成されたファイルを out/ に保存
cat log.txt | yobitsugi -p "エラーの原因をまとめて"       # 標準入力から受け付け
yobitsugi -p -c "さっきの表に前年比を追加して"           # このフォルダで最後に使ったセッションを再開
yobitsugi -p --output-format json "…"                # 結果を JSON で出力(ほかのツールから利用する場合)
yobitsugi -p --output-format stream-json "…"         # 途中の出来事を 1 行ずつ JSON で出力
yobitsugi -p -o out --share "商品写真を 3 枚作って"     # 作成された画像を保存し、公開リンクも作成
yobitsugi --allow write "README の使い方の節を書き直して"  # このフォルダのファイルを AI が読み書き(書き込みは確認なし)
yobitsugi connect ~/project                          # このパソコンをつないだままにして、Web やスマホの会話から使う

対話モードのコマンド: /new(新しいセッション)・/sessions(セッション一覧)・/resume <ID>・/model [ID]・/balance(クレジット残高)・/files(このセッションのファイル)・/get <パス> [保存先]・/open(ブラウザで開く)・/link(このセッションのリンク)・/watch(バックグラウンドの処理のあと、AI が続けた内容を表示)・/server <ID>(常駐サーバーの URL と ID・パスワード)・/lock(合言葉でロック)・/relock(今すぐロック)・/local [on|off](手元のフォルダ)・/allow write|exec|all・/deny write|exec|all・/help・/exit。Ctrl+C で実行中の依頼を停止できます(-p のときも停止します)。

対話モードで複数行のメッセージを送るときは、そのまま貼り付けるか、行の終わりに \ を付けて次の行を続けて入力してください。

AI からの質問とロック

  • AI が確認の質問をしたときは、選択肢の番号(複数のときは 1,3)か文字で答えます。何も入力せずに Enter を押すと、答えずに続けます。-p で実行したときは、yobitsugi -c で再開して答えてください。
  • 時間のかかる処理をバックグラウンドで実行しているときは、見込みの時間と終わる時刻を表示します。終わると AI が続きを進めます。
  • 合言葉でロックしたセッションやグループを開くときは、合言葉を入力すると解除できます。

コマンドとオプション

| コマンド | 内容 | |---|---| | yobitsugi login / logout / whoami | ログイン・ログアウト・ログイン中のアカウントを表示 | | yobitsugi sessions / models / balance | セッション一覧・モデル一覧・クレジット残高 | | yobitsugi get <パス> [保存先] | マイファイルからダウンロード | | yobitsugi files [フォルダ] | マイファイルの一覧(--session <ID> でそのセッションの作業場) | | yobitsugi put <ファイル...> | 手元のファイルをマイファイルへアップロード(--to <フォルダ>) | | yobitsugi share <パス> / unshare <パス> | 公開リンク(ログインなしで開ける URL)を作る・やめる | | yobitsugi follow <セッション ID> | 次の回(バックグラウンドの処理のあとに AI が続けた回など)を終わりまで表示 | | yobitsugi stop <セッション ID> | 実行中の作業を止める | | yobitsugi api <METHOD> </api/…> | Web の画面と同じ API をそのまま呼ぶ(--data に JSON)。画面でできることは、すべてこれでもできます | | yobitsugi connect [フォルダ...] | このパソコンをつないだままにして、Web やスマホの会話から AI にフォルダのファイルとコマンドを使わせる |

| オプション | 内容 | |---|---| | -p, --print | 1 回だけ実行して結果を表示 | | -c, --continue / -r, --resume <ID> | セッションを再開 | | -m, --model <ID> / --effort <レベル> | モデルと推論の深さ(新しいセッションのとき) | | -o, --out <フォルダ> | 作成されたファイルをダウンロード | | --output-format <形式> | text(既定)・json・stream-json | | --share | 作成されたファイルの公開リンクも作る(-p のとき) | | --local / --no-local | いまのフォルダを AI に使わせる・使わせない(-p は --local を付けたときだけ) | | --allow <機能> | 書き込み(write)・コマンドの実行(exec)・両方(all)を、確認せずに許可 | | --folder <フォルダ> | AI に使わせるフォルダを足す(何度でも) | | --name <名前> | つないだときの名前(既定「CLI(コンピューター名)」) | | --allow-secrets | .env や鍵などのファイルの添付・読み取りを確認せずに許可 | | --no-browser | login のときにブラウザを開かず、URL を表示(表示されたコードを貼り付けてログイン) | | --token <鍵> | login のときに、管理者から受け取った鍵でログイン(- を指定すると貼り付け。コマンドの履歴に残りません) |

AI やスクリプトから使う

画像・動画・音声・資料などの生成も、Web の画面と同じようにコマンドから依頼できます。結果は次の形で受け取れます。

  • -o <フォルダ>: 作成されたファイルを手元に保存
  • --output-format json: 終わったときに JSON を 1 つ出力。outputs に作成されたファイルの一覧(path・mime・size・downloadUrl・publicUrl・local)が入ります。downloadUrl はログインが必要な URL で、yobitsugi get で取り出せます。--share を付けると publicUrl(ログインなしで開ける URL)も作ります
  • --output-format stream-json: 途中の出来事(AI の文・ツールの実行・ファイルの作成・公開リンクなど)を、サーバーから届いた順に 1 行ずつ JSON で出力

手元のフォルダで作業する

AI が、あなたの許可を得て、手元のパソコンのファイルを読み書きしたり、コマンドを実行したりできます(Node.js 22 以上)。

  • 対話モードを初めて開いたフォルダでは、「このフォルダのファイルを AI が読めるようにするか」を聞きます。答えはフォルダごとに覚えます(/local on・/local off で変更)。ホームのフォルダでは聞かず、--local を付けたときだけ使います。
  • AI が使えるのは、許可したフォルダの中だけです(--folder で足せます)。
  • ファイルの書き込み・移動・削除(OS のごみ箱へ移します)と、コマンドの実行は、その都度ターミナルで確認します。y(はい)・n(いいえ)・a(この起動中はすべて許可)で答えます。最初から許可するときは --allow write・--allow exec・--allow all を付けます。
  • .env や鍵など、秘密情報を含む可能性のあるファイルは、読む前にも確認します。
  • -p で使うときは --local を付けます。確認に答えられない使い方(パイプやスクリプト)では、--allow で許可したものだけを行います。
  • yobitsugi connect [フォルダ...] は、会話をせずにこのパソコンをつないだままにします。Web やスマホの YOBITSUGI AI で「つないだ CLI のフォルダで…」と頼むと、AI がそのフォルダを使います。画面の無いサーバーでも使えます。Ctrl+C で終了します。
  • AI が行った操作は、ターミナルに 1 行ずつ表示し、YOBITSUGI AI の設定の「つないだ端末」にも記録します。Ctrl+C で、実行中の操作とコマンドを止めます。
  • 同じログインでつなげる CLI は 1 つです。別のターミナルでつなぐと、前のほうは終わります。

ファイルの添付とダウンロード

  • メッセージ内の @ファイル名 で、ローカルのファイルを添付できます(一度に 10 個まで・1 ファイル 100MB まで)。ファイル名のあとに空白を入れずに文を続けても(例: @売上.csvを集計して)添付します。見つからないファイルは、添付していないことを表示します。
  • .env・秘密鍵・証明書など、秘密情報を含む可能性のあるファイルは、誤って送信しないよう添付を中止します。添付する場合は --allow-secrets を指定してください。
  • 作成されたファイルは -o または /get でダウンロードできます。同じ名前のファイルがある場合は上書きせず、番号を付けて保存します。

セキュリティ

  • ログインは、ブラウザでの認証(認可コード + PKCE)で行います。パスワードを CLI に入力することはありません。貼り付けるコードは 10 分間・1 回だけ有効で、ログインを始めた CLI でなければ使えません。
  • ログイン情報は ~/.config/yobitsugi/(Windows は %APPDATA%\yobitsugi\)に、本人だけが読める権限で保存します。yobitsugi logout で削除し、サーバー側でも無効にします。
  • ログイン中の端末は、YOBITSUGI AI の設定の「セキュリティ」→「ログイン中のアプリ」から確認・ログアウトできます。
  • AI の出力に含まれる制御文字は、表示の前に取り除きます。
  • 手元のフォルダで作業するときは、許可したフォルダの外(シンボリックリンクで外へ出るものを含む)のファイルには触れません。

料金

AI の利用に応じて、YOBITSUGI AI のクレジットが差し引かれます。料金は料金のページをご覧ください。

お問い合わせ

お問い合わせ

ライセンス

LICENSE をご覧ください。ご利用には YOBITSUGI AI の利用規約が適用されます。

更新

  • 一度入れたら、1 日 1 回新しい版を確かめて、自動で更新します(コマンドが終わったあと、裏で入れ替えます)。
  • yobitsugi update で、いますぐ最新の版に更新します。
  • yobitsugi update manual で手動に切り替えると、新しい版があることを知らせるだけになります。yobitsugi update auto で自動に戻します。