スキル

Meegle CLI:端末で飛書プロジェクトの作業項目と日程を管理する

ブラウザを開かず端末で Meegle(飛書プロジェクト)の作業項目・日程・データを管理したい人向け。前提は Node.js 16 以上と、公式インストールウィザードでログインまで終えること。

公式ソース · Meegle CLI

インストール

npx @lark-project/meegle@latest install

誰向けか

すでに Meegle(飛書プロジェクト)を使っていて、ブラウザを開かずに端末で作業項目・日程・データを管理したいなら、このツールは合う。Meegle のコマンドラインツールである。説明ページは

https://github.com/larksuite/meegle-cli

より合う人は、ログインできる Meegle スペースを持ち、手元の Node.js は 16 以上(npm / npx 付き)で、公式のこの1本の導入コマンドだけを受け入れる。インストールウィザードは:CLI をグローバル導入またはアップグレードし、付属の AI Agent Skill を入れ、Meegle ホストを設定し、ログインを始める。この4ステップはどれも手元環境を変える。手元で認可を終える気がある人に合う。

ウェブで作業項目をクリックするだけで、グローバル CLI を入れる気も、agent にプロジェクトデータを呼ばせる気もないなら、このウィザードは不要。公式は、ウィザードが付属スキルをいくつかの開発環境へ入れると書き、他の agent にも触れる。名指しを排他名簿と読まず、未記載のマーケット導入も探さない。最初は読み取り専用の閲覧であり、作成や日程変更ではない。ウィザードは CLI とスキルを同じ導入に縛る。スキルフォルダをコピーしてログインを飛ばせない。Meegle ホストアドレスとログインできるアカウントが無いなら、先にその二つを用意してから npx を実行する。

3分で最初の試行を完える

公式の導入経路はこの1本だけ使う。

npx @lark-project/meegle@latest install

skills add やプラグイン、マーケット指令へ書き換えない。実行前に確認する:手元は Node.js >= 16。このマシンへ CLI をグローバル導入する準備がある。続けてホストを設定しログインを終える気がある。この4つには副作用がある。ウィザードが書き込む場所とログインするホストを先に見て、確認してから続ける。

入れたあと、使う agent を再起動し、付属スキルが出たことを確認する。公式はスキルのスラッシュコマンドも CLI サブコマンド一覧も書いていない。最初の起動はウィザードが入ったスキル名に従う。

ログイン済みでスキルが見える agent で、低リスクの作業を1回する。作業項目や現在の日程を読み取り専用で見るよう頼む。先に呼び出すコマンドまたはスキル名、手元へ書くか、Meegle 上のフィールドを変えるかを出させる。純粋な読み取りだと確認してから問い合わせを許す。

成功の合図:端末または会話に Meegle 由来の作業項目や日程データが出て、もうブラウザを開けとは言わない。ウィザードがログインページで止まったら、先にホスト設定とログインを終える。未記載のパッケージ名に切り替えない。スキルが見えなければ agent を再起動し、ウィザードがスキル導入の段まで進んだか確認する。データを読むのにブラウザが必要だと言われるなら、ログインかホストが未完了。別パッケージを入れ直すのではなくウィザードへ戻る。

使用例

例1:端末で作業項目を見る。公式の能力は作業項目・日程・データの管理。最初は閲覧だけ。見る権限があるスペースまたはビューを指定し、付属スキルまたは CLI に作業項目の題名と状態を読ませる。ページに具体的なサブコマンド綴りは無い。欠けていれば入済みスキルに「読み取り専用で作業項目を出す」と聞く。meegle xxx を捏造しない。作成・割当・クローズは計画ステップで止める。

例2:日程とデータを見る。ブラウザ手順は変えない。同じ文が schedules と data と work items を並べる。やり方は同じスペースの日程またはフィールドデータを読み、カレンダー照合に使うことであり、日付を変えることではない。ログイン未完了なら走らせない。公式は書き出し形式も一括日付変更インタフェースも書いていない。書いていない一括更新はしない。両方の例は、ウィザードが CLI・スキル・ホストを入れログインまで終えたあとに立つ。第二の導入ではない。会話に説明ページに無いサブコマンドが出たら、先にウィザードが入ったスキル説明と突き合わせ、合わなければ実行しない。

利用上の境界

実行要件は Node.js >= 16 と npm / npx。それ未満なら導入コマンドを無理に変えない。ウィザードは CLI をグローバル導入またはアップグレードし、スキルを書き、ホストを設定しログインを始める。「スキルだけ入れてログインしない」ではスペースデータは期待できない。

公式導入は npx @lark-project/meegle@latest install だけ。第二の skills add やプラグインマーケット経路を発明しない。紹介で触れた環境名は唯一の利用名簿ではない。名指しされていない環境は保証も排除もされない。ウィザードが実際に書いた場所に従う。

作業項目と日程の管理は書き込みに当たる。確認前は読み取りだけ許す。公式にサブコマンド表は無く、ログアウト、アンインストール、複数ホスト切替の手順も無い。欠けていればウィザードが終えた範囲に止まる。製品ホームページや飛書プロジェクト紹介ページを第二の導入アドレスにしない。グローバルな CLI アップグレードは旧版を上書きし得る。ウィザード実行前にアップグレードを受け入れるか確認する。ログインは認可フローを開く。信頼できないマシンでは走らせない。