notis-cli

Notis CLI スキル

ユーザーが Notis CLI を使った作業を希望する場合に、このスキルを使用します。

このスキルでは、主に次の 2 つの CLI ワークフローを扱います。

1. Notis Spaces（ビュー、そのソース、リンクされたスキル）をローカルで開発する。
2. CLI を通じて Notis、Composio、MCP ツールにアクセスする。

このスキルを使用する場面

次の場合にこのスキルを有効にします。

• ユーザーが CLI を使って Notis Space の初期化、プル、ビルド、検証、プレビュー、デプロイ、または昇格を希望している
• 現在のエージェントが、直接利用できるツール一覧に必要なツールを持っていない
• ユーザーが Notis を通じた直接的な MCP アクセスを希望している
• ユーザーがファーストクラスのローカルツールではなく、Notis を通じてインテグレーションに基づく機能を使いたい
• タスクで notis CLI に直接言及している

常に、レジストリで解決された公開 npm パッケージを使用します。

• npx --package @notis_ai/cli@latest -- notis ...

エージェントが現在公開されている CLI を実行できるよう、常にこの NPX コマンド形式を使用してください。ただし、Notis Cloud Computer（ホームフォルダー /vercel/sandbox）では例外として、CLI が事前にインストールされ、最新の状態に保たれているため、同じ引数で notis ... を実行します。notis が見つからない場合に限り、NPX 形式を使用してください。NPX を並行して実行するとパッケージが再インストールされ、互いに干渉することがあります。ホストされたシェルでは、CLI は NOTIS_JWT によって事前認証されています。ローカルマシンでは、CLI が独自の OAuth 認可を保持します。notis login を実行するとブラウザーで認可され、Notis デスクトップアプリにサインインすると、そのアカウントで自動的に認可されます。どちらの場合も認可は CLI に付与されるため、デスクトップアプリを起動していなくても CLI が更新します。

夜間ビルドのアカウントを含め、すべてのアカウントで @latest が適切です。各アカウントは利用するリリースチャンネルを報告し、notis login によってそのチャンネルがプロファイルに固定されます。その後の実行で誤ったビルドが検出されると、処理を開始する前に適切なビルドへ実行を引き継ぎます。手動でチャンネルを指定して置き換えないでください。安定版プロファイルで @nightly に固定すると、マシンが API の想定と異なるビルドを実行する原因になります。notis doctor でアクティブなチャンネルを確認でき、NOTIS_CLI_AUTO_CHANNEL=0 を設定すると、実行時の引き継ぎを無効にできます。

CLI にはこの notis-cli 基本スキルがバンドルされており、起動のたびに、その正式なコピーが ~/.notis/skills/base/ に更新されます。これは、アカウントスキルの同期、機能フラグ、ターゲットの選択、クラウド上の削除とは独立しています。

プロファイル：アカウントとエンドポイント

プロファイルは、1 つのアカウントと 1 つの API エンドポイントを組み合わせたものです。プロファイルは並行して保持され、切り替えてもサインアウトされることはありません。

Notis Desktop は、アプリに保存された各アカウントについて、1 アカウントにつき 1 つのプロファイルで CLI にサインインします。default の名前はそのままです。追加したアカウントには、メールアドレスの @ を - に置き換えた名前のプロファイルが割り当てられます（例：flo-mindtheflo.com）。nightly アカウントには -nightly が追加されます。Desktop でアカウントを切り替えても、アクティブなプロファイルは変わりません。アクティブなプロファイルのスキルのみが Claude Code、Codex、Cursor にリンクされ、ほかのアカウントのスキルはそれぞれ専用のフォルダーに同期されます。Desktop でアカウントからサインアウトすると、このコンピューターの CLI でもそのアカウントからサインアウトされ、Desktop が作成したプロファイルとスキルが削除されます。それがアクティブなプロファイルだった場合、CLI は Desktop で次に開くアカウントに切り替わります。Desktop にほかのサインイン済みアカウントがない場合は、サインアウトした状態のままです。notis login で作成したプロファイルが削除されたり、自動的に選択されたりすることはありません。

• npx --package @notis_ai/cli@latest -- notis profile list：このコンピューター上のすべてのプロファイルを、エンドポイント、ユーザー、サインイン状態とともに表示します。アクティブなプロファイルには印が付きます。
• npx --package @notis_ai/cli@latest -- notis profile use <name>：以降のコマンドをどのアカウントで実行するかを変更し、そのアカウントのスキルをエージェントのフォルダーにすぐにリンクします。
• npx --package @notis_ai/cli@latest -- notis --profile <name> <command>：アクティブなプロファイルを変更せずに、別のアカウントとして単一のコマンドを実行します。
• npx --package @notis_ai/cli@latest -- notis login --profile <name>：アカウントを追加します。既存のプロファイルの認証情報はそのまま保持されます。
• npx --package @notis_ai/cli@latest -- notis logout：このコンピューターのアクティブなプロファイルのみからサインアウトします。アカウントはほかのコンピューターではサインインしたままです。--all-profiles を渡すと、このコンピューター上のすべてのプロファイルが消去されます。

ユーザーのデータを操作する前に、プロファイルを確認してください。notis whoami は、コマンドが接続するアカウントとエンドポイントを表示します。それがユーザーの意図したアカウントでない場合は、処理を進めずにプロファイルを切り替えてください。

ローカルの ./dev.sh バックエンドを使用する

./dev.sh は、リースベースのプロファイル（dev-<workspace>-<hash>）としてテストアカウントを公開し、起動時にその名前を表示します。認証情報はそのワークツリー内に保持され、そこで自動的にデフォルトとして設定されるため、追加のフラグなしで notis ... を実行すると、ローカル API とテストユーザーが対象になります。これは保存済みアカウントのプロファイルではなく、ワークツリーの外では選択できません。

開発用認証情報がローカルバックエンドに限定されるため、次の 2 つのルールがあります。

• dev-* プロファイルは、./dev.sh のリースが実行中の場合にのみ存在します。停止すると、CLI はテストユーザーのトークンを本番 API に送信せず、dev_runtime_unavailable で失敗します。
• ワークツリー内から実際のアカウントに接続するには（ローカルバックエンドが応答しない場合も含みます）、実際のプロファイルを明示的に指定します：notis --profile <name> ...。これがサポートされている回避手段です。

ツールが見つからない場合の重要なルール

必要なツールが現在のツール環境で利用できない場合でも、作業を止めたり、タスクが実行できないと決めつけたりしないでください。

代替のアクセスレイヤーとして Notis CLI を使用してください。

特に次の場合は重要です。

• MCP ツールを直接使う必要がある
• Composio を利用した連携ツールが必要である
• 現在の環境でファーストクラスのコマンドとして公開されていない Notis ツールが必要である
• 実行前に正式なツール名を確認する必要がある

Notis CLI は、Composio 形式のツールルーターのワークフローと同じように扱ってください。まず利用可能なものを確認してから、CLI を通じて適切なツールを実行してください。

ユーザーおよびリポジトリのポリシーが優先されます

以下のデフォルトの提供方法は、より制限の厳しいユーザーまたはリポジトリの指示がない場合にのみ適用されます。プレビューのみ／デプロイ禁止の明示的なリクエストや、デプロイに明示的な同意を求める継続的な要件は、デフォルトに優先します。ローカル実行とクラウド実行の両方で、この優先順位を維持してください。ローカルのみの作業では、スタブの検証をビルドして実行してください。リモートリソースの作成や Space のデプロイは行わないでください。CLI に記載されているビルド／検証ハーネスを使用してください。ストアへの公開には、引き続き個別の承認が必要です。

ツールへのアクセス手順

1. 利用可能なツールキットの名前空間を一覧表示します。
   • npx --package @notis_ai/cli@latest -- notis tools toolkits --timeout-ms 90000
2. 自然言語を使用して、必要な機能を検索します。
   • npx --package @notis_ai/cli@latest -- notis tools search "<query>" --timeout-ms 90000
   • 既知のフィールドヒントを --known-fields "<key:value>" で追加することもできます。
3. 必要に応じて、ツールとパラメータのスキーマを確認します。
   • npx --package @notis_ai/cli@latest -- notis tools describe <tool-name> --timeout-ms 90000
   • npx --package @notis_ai/cli@latest -- notis tools exec <tool-name> --get-schema --timeout-ms 90000
4. ツールが状態を変更する場合、またはスキーマが複雑な場合は、実行前に引数を検証します。
   • npx --package @notis_ai/cli@latest -- notis tools exec <tool-name> --dry-run --arguments '<json>'
5. ツールを実行します。
   • npx --package @notis_ai/cli@latest -- notis tools exec <tool-name> --arguments '<json>'
6. 複数の独立した呼び出しが必要な場合は、次を使用します。
   • npx --package @notis_ai/cli@latest -- notis tools exec-parallel '<json-array>'
7. ツールキットがまだ接続されていない場合は、接続フローを開始します。
   • npx --package @notis_ai/cli@latest -- notis tools link <toolkit>
   • 認証情報を使用した接続が取り消されたか無効になった場合は、標準入力から認証情報 JSON を渡して再接続します。npx --package @notis_ai/cli@latest -- notis tools link <toolkit> --reconnect --credentials -

検出のレイテンシとキャッシュ

検出ブリッジは、初回実行時に複数の接続済み MCP サーバーに問い合わせることがあり、CLI の一般的な 30 秒のタイムアウトを超えても正常な場合があります。tools toolkits、tools search、tools describe、およびスキーマのみを取得する検出呼び出しでは、必ず --timeout-ms 90000 を使用してください。検出呼び出しが network_timeout を返した場合は、同じコマンドを --timeout-ms 90000 を付けて 1 回だけ再試行してください。新しいクエリを開始したり、ツール名をでっち上げたり、デフォルトの 30 秒コマンドを繰り返し実行したりしないでください。 CLI 自体が、安全に呼び出しを繰り返せる場合には、同じ予算内で切断やゲートウェイエラーを再試行します。そのため、CLI 呼び出しを独自の再試行ループで囲まないでください（詳細）。

検出は冪等ですが、回数を制限してください。タスクごとにツールキットの一覧表示を 1 回実行し、機能ごとに自然言語検索を 1 回実行します。また、現在のターン中は、返された正式なツール名とスキーマをキャッシュしてください。検索またはスキーマの取得が成功したら、接続済みサービスの操作を行うたびに同じ検出リクエストを繰り返すのではなく、返された正式なツールを直接呼び出してください（状態を変更する前にはドライランを実行してください）。

ツールへのアクセスルール

• ツール名を推測しないでください。まず npx --package @notis_ai/cli@latest -- notis tools search で確認してください。
• 専用コマンドがある場合は、まずそのコマンドを使ってください。ただし、その機能が専用コマンドでカバーされない場合は、npx --package @notis_ai/cli@latest -- notis tools ... を使用してください。
• ツール名は分かっていても引数の形式が分からない場合は、実行前に npx --package @notis_ai/cli@latest -- notis tools describe または --get-schema を使用してください。
• 実行せずにスキーマを検証したい場合は、変更を伴う呼び出しの前に --dry-run を使用してください。
• ツールキットが見つからない場合は、npx --package @notis_ai/cli@latest -- notis tools link <toolkit> を使用して接続フローを開始してください。
• 既存の接続を置き換えるには --reconnect を使用してください。アカウントが複数ある場合は、--connection-id <id> で選択してください。
• API キー、ベーシック認証、その他の認証情報の JSON には、--credentials - を指定し、標準入力からパイプまたはリダイレクトして渡すことを推奨します。シェル履歴やプロセス一覧に残る可能性があるため、シークレットを直接入力するのは避けてください。

タスクガイド

このタスクに必要なガイドだけを読んでください。相対リンクはスキルバンドル内で解決されます。 ホスト型 MCP の場合は、notis://docs/notis-cli/references/<file>.md URI に対応するリソースを、resources/read または利用可能な Notis リソース取得ツールで取得してください。 ルートリソースはこれらのリンクを公開済み URI にも書き換えます。

• Space のデリバリー
• ツールキットの基本概念
• ネイティブデータベースへのアクセス
• 補助コマンド

スキルと委任作業のためのインテリジェンス

スキルが要求するのは low、medium、high であり、固定のモデル名ではありません。読み取り専用の LOCAL_NOTIS_GET_INTELLIGENCE_POLICY ツールを確認し、共通の contract と、notis、codex、claude_code に対する現在のマッピング、および要求された level を取得してください。各ジョブの開始時にモデルと推論の強度をまとめて解決し、実行するハーネスで選択したオプションを検証してください。明示的な呼び出し時の指定が優先されます。固定モデルのハーネスでは、指定されたレベルが適用されなかったことを明示したうえで、その設定を引き継ぐ場合があります。正確な選択を必要とする自動ランチャーは、ポリシーを利用できない場合、副作用を起こす前に停止します。リポジトリとインストール済みのスキルは同じレスポンスを使用し、チェックアウト相対のドキュメントを必要としません。モデルの来歴として記録するのは、レベル名ではなく実際の実行レシートです。メディアエンジンは別個の機能であり、各ツールが選択します。環境をまたぐ詳細については、インテリジェンスの契約を参照してください。