meticulous-cli-update

Meticulous CLI をインストールまたは更新する

@alwaysmeticulous/cli パッケージは現在も活発に開発されており、頻繁に変更や改善が加えられています。他の Meticulous スキルでは、meticulous コマンドが PATH 上にあり、最新の状態であることを前提としています。そのため、Meticulous のワークフローを開始する際に、このスキルを一度実行してください。

実行が必要なのは、会話ごとに一度だけです。この会話の早い段階ですでに実行済みの場合は、スキップしてください。Meticulous スキルを呼び出すたびにバージョンを再確認したり、更新し直したりする必要はありません。

CLI の代わりに MCP サーバーを使用していますか？ 手順 1〜4 は meticulous CLI バイナリとそのローカル認証のインストール／更新に関するもので、ホストされている Meticulous MCP サーバー のツールを呼び出す場合は、どちらも必要ありません。このサーバーはすでに最新バージョンであり、meticulous auth login ではなく MCP 接続を介して認証します。手順 5 に進んでください。インストール済みのスキル（このドキュメント一式）は CLI／MCP ツール自体とは別のものであり、どちらを介してツールを呼び出す場合でも、引き続き最新の状態にしておく必要があります。MCP でのログイン時に注意すべき点がひとつあります。Claude Code で「Issuer mismatch in authorization response (RFC 9207)」というエラーが発生してサインインに失敗する場合、古い認可サーバー URL がキャッシュされて再利用されています。ユーザーには、/mcp で Meticulous サーバーの Clear authentication（Re-authenticate ではありません）を選択してから、もう一度認証するよう伝えてください。

CLI のインストール、MCP サーバーへの接続、これらのスキルのインストールを含むセットアップ手順は、app.meticulous.ai/docs/agents/setup にあります。

インストール／更新コマンドの扱い方

通常、このスキルは別の Meticulous スキルのサブステップとして実行されます。以下のインストール／更新コマンド（手順 1、3、5）はセキュリティ上の注意が必要です。パッケージをインストールし、ネットワークに接続するため、ベストエフォートで、処理を妨げないものとして扱ってください。

• コマンドがホワイトリストに登録されているかどうかは、通常、事前には判断できません。ホワイトリストに登録されていれば無言で実行され、登録されていなければ、実行を試みた際に権限の確認が表示されます。どちらでも問題ありません。これを判断材料にしてください。
• 必要な権限がない場合（確認が表示された場合、またはユーザーが許可しなかった場合）は、無理に実行するのではなく、_推奨にとどめる_合図として扱ってください。たとえば、「npm install --global @alwaysmeticulous/cli@latest を実行して Meticulous CLI を更新することをおすすめします」とユーザーに伝えて、先に進んでください。確認が拒否されても、失敗ではありません。「後で実行する」という意味にすぎません。
• ユーザーが今は実行したくない場合でも、続行してください。 ワークフローを止めず、残りの手順を進めてから、呼び出し元のスキルに戻ってください。唯一の必須要件は、meticulous コマンドが存在すること（手順 1）です。実際にインストールされておらず、ユーザーがインストールを拒否した場合は、Meticulous スキルを続行できないため、その時点で停止してください。

読み取り専用の確認（meticulous --version、npm view …、meticulous auth whoami）は、そのまま安全に実行できます。

手順 1 — インストール済みバージョンを確認する

meticulous --version

コマンドが見つからない場合、CLI はインストールされていません。グローバルにインストールしてください（ベストエフォートで実行してください。上記の注記を参照）。

npm install --global @alwaysmeticulous/cli@latest

インストールがホワイトリストに登録されていない場合は、ユーザー自身でこのコマンドを実行するようおすすめしてください。CLI がなければ Meticulous スキルを実行できないため、ユーザーがインストールを拒否した場合は、ここで停止して待つ必要があります。インストールしたら、meticulous --version を再実行して PATH 上にあることを確認し、手順 4 に進んでください。

手順 2 — 公開されている最新バージョンを確認する

npm view @alwaysmeticulous/cli version

Step 3 — CLI が古い場合は更新する

インストール済みのバージョンがすでに最新の場合は、Step 4 に進んでください。

そうでない場合は、CLI のインストール方法に応じて更新してください（ベストエフォートで実施します。上記の注記を参照してください。更新が許可リストに含まれていない場合は、適切なコマンドを実行するようユーザーに案内し、いずれにしても続行してください）。

• グローバルにインストールされている場合（一般的なケースです。which meticulous が現在のプロジェクト外のパスを返します）：

  npm install --global @alwaysmeticulous/cli@latest
  

• プロジェクトにローカルインストールされている場合（プロジェクトの package.json に @alwaysmeticulous/cli があり、which meticulous が node_modules/.bin 内のパスを返します）：

  npm install --save-dev @alwaysmeticulous/cli@latest
  # or, if the project uses pnpm:
  pnpm add --save-dev @alwaysmeticulous/cli@latest
  # or yarn:
  yarn add --dev @alwaysmeticulous/cli@latest
  

更新を実行した場合は、meticulous --version を再実行し、続行する前に最新バージョンと一致することを確認してください。

Step 4 — 認証とプロジェクトの選択を確認する

ユーザーが Meticulous で認証済みであり、プロジェクトが選択されていることを確認してください。

meticulous auth whoami

構造化出力に基づいて分岐したい場合は、--json を追加してください。authenticatedVia と selectedProject が出力されます。

結果は次の 4 通りです。

(a) OAuth でサインイン済みで、プロジェクトが選択されている

Authenticated via: OAuth
Logged in as: Jane Smith ([email protected])
Organizations: acme-corp (member)
Selected project: acme-corp/Web App

何もする必要はありません。Step 5 に進んでください。

(b) API トークンまたは注入された認証情報で認証済み

Authenticated via: project API token (METICULOUS_API_TOKEN environment variable)
Pinned project: acme-corp/Web App

project API token (~/.meticulous/config.json)、test-run API token、または credentials injected at request time（エージェントプラットフォームが app.meticulous.ai への送信リクエストにベアラー認証情報を付加する場合）として表示されることもあります。これらの認証情報は単一のプロジェクトに紐づいており、そのプロジェクトはすでに固定されているため、選択するものはありません。meticulous auth set-project は実行しないでください。API トークンではエラーになります（トークンは 1 つのプロジェクトに紐づいているため）。認証情報が注入されている場合も、選択するものはありません。Step 5 に進んでください。

(c) 「Not logged in」

コマンドを実行すると、次のように表示されます。

Not logged in. Run meticulous auth login, or set METICULOUS_API_TOKEN. In terminals without a browser, use meticulous auth login --non-interactive.

サインインにはブラウザーでの SSO を使用するため、必ず人がブラウザーで認証を完了する必要があります。使用するログインコマンドは、実行場所によって異なります。

• ユーザー自身のマシン上（そのマシンのローカルホストにブラウザーからアクセスできる場合）：

  meticulous auth login --non-interactive
  

  ログイン URL が出力された後、ローカルのコールバックサーバーで待機するため、バックグラウンドで実行してください。その後、出力された URL をユーザーに提示し、開いてサインインを完了するよう依頼してください。完了するとコマンドが終了し、トークンが保存されます。その後、続行できます。

  または、ユーザー自身のターミナルでブラウザーが直接開くよう、meticulous auth login を実行するよう依頼してください。

• リモートまたはサンドボックス化されたマシン上（クラウドエージェント、SSH セッション、コンテナなど）で、別のデバイスのブラウザーからこのマシンのローカルホストにアクセスできない場合：

  meticulous auth login --device
  

  これは OAuth デバイスフローを使用します。ローカルのコールバックを待機する代わりに、URL と短いコードが出力されます。バックグラウンドで実行し、URL とコードをユーザーに提示して、任意のデバイスで URL を開き、コードを入力するよう依頼してください。確認が完了するとコマンドが終了し、トークンが保存されます。

どちらの方法でも対話型のプロジェクト選択画面は省略されるため、使用するプロジェクトがわかっている場合は、--project "Organization/Project" を追加してください。これにより、ログインとプロジェクトの固定が一度に行われます。--project を指定しない場合、複数のプロジェクトにアクセスできるアカウントは、下記のケース (d) に該当します。そのため、ログイン完了後に meticulous auth whoami を再実行し、表示されたケースに応じて対応してから Step 5 に進んでください。

人がまったく対応できない CI のような環境では、ログインの代わりに API トークンを使用できます。METICULOUS_API_TOKEN を設定するか、--apiToken を渡してください。

(d) OAuth でサインイン済みだが、デフォルトプロジェクトが設定されていない

whoami は成功しますが、さらに次の内容がログに出力されます（stderr）。

デフォルトプロジェクトが設定されていません。meticulous auth set-project を実行して選択してください。

この状態では、プロジェクトスコープのコマンドでプロジェクトを解決できません。複数のプロジェクトへのアクセス権があるアカウントで発生します。ピッカーがスキップされる --non-interactive または --device でのログイン直後も同様です。選択肢を一覧表示してから、1 つを固定します。

meticulous auth list-projects   # one "organization/project" slug per line
meticulous auth set-project --project "Organization/Project"

どれを使うかユーザーに確認してください。ただし、曖昧でない場合（たとえば、プロジェクトが 1 つしか表示されない場合や、リポジトリがそのうちの 1 つに明らかに対応している場合）は除きます。あるいは、ユーザー自身に meticulous auth set-project を実行してもらってください。--project を指定しなければ、対話型ピッカーが表示されます。

選択内容はマシンではなくアカウントに保存されるため、MCP サーバーやユーザーの他のマシンにも適用されます。meticulous auth get-project は、現在解決されているプロジェクトを単独で出力します。

ステップ 5 — インストール済みの Meticulous スキルを更新する

スキル自体も現在活発に開発されています。更新方法はインストール方法によって異なります（ベストエフォートです。上記の注記を参照してください）。

• npx skills でインストールした場合 — デフォルトです。スキルファイルは、skills-lock.json とともに、.claude/skills/、.cursor/skills/、またはエージェントに対応する同等の場所にあります。

  # Install or update all skills, for the specified agents
  npx skills add alwaysmeticulous/skills --skill "*" --agent claude-code --agent codex --agent cursor -y
  

  プロジェクト内に skills-lock.json（またはスキルファイル自体）があることを確認してから実行してください。そうしないと、プラグインのインストールに加えてもう 1 つコピーがインストールされます。

• Claude Code プラグインとしてインストールした場合 — スキルは /meticulous:<skill-name> のように名前空間付きで表示され、claude plugin list には meticulous@meticulous と表示されます。npx skills では更新されないため、代わりにプラグインを更新してください。

  claude plugin update meticulous@meticulous
  

  更新を反映するには Claude Code の再起動が必要であることをユーザーに伝えてください（ユーザー自身で /plugin メニューから操作することもできます）。例外として、claude plugin list でプラグインのスコープが managed と報告される場合は、組織の管理設定によって固定されています。更新を試みず、その旨をユーザーに伝えてください。

• Codex プラグインとしてインストールした場合 — codex plugin list には meticulous@meticulous と表示されます。こちらも npx skills では更新されません。マーケットプレイスを更新してください。プラグインに変更があれば、再インストールも行われます。

  codex plugin marketplace upgrade meticulous
  

  更新は次の Codex セッションで反映されます。

• Cursor プラグインマーケットプレイスからインストールした場合 — 実行するコマンドはありません。Cursor の Customize → Plugins から更新するようユーザーに案内してください。

該当するコマンドが許可リストにない場合は、ユーザー自身で実行するよう案内してください。いずれの場合も、コマンドを実行したか、ユーザーが断ったかにかかわらず、呼び出し元のスキルを続行してください。