mcpField
C
community-cli-howto

community-cli-howto

github.com/stahuraデータ・データベース24176 回インストール26 週間前に更新
リポジトリ

community-cli-howto について

community-cli-howto は、対応する Domo エンドポイントで community-domo-cli を実行・トラブルシューティングするためのリポジトリスキルです。Ryuu セッション認証やコマンド、操作上の制約を、CLI 利用者とコントリビューター向けにまとめています。

主な機能

  1. 01Ryuu セッション認証の設定
  2. 02Domo コマンドリファレンス
  3. 03呼び出し方法と識別子の確認
  4. 04変更操作のドライラン案内

活用シーン

  1. 01Domo インスタンスの CLI 認証設定
  2. 02対応エンドポイントのコマンド確認
  3. 03CLI 呼び出しや識別子エラーの調査
  4. 04変更前のリクエスト内容の検証

インストール

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

$npx skills add https://github.com/stahura/domo-ai-vibe-rules --skill community-cli-howto

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

詳細

Community Domo CLI

目的

このリポジトリで、現在ロックされているエンドポイントの範囲に基づいて community-domo-cli コマンドを実行し、トラブルシューティングを行います。

インストールと実行

ユーザー向けの推奨手順：

pipx install "git+https://github.com/stahura/community-domo-cli.git"
community-domo-cli --help

コントリビューター／テスト向けの手順：

python3 -m pip install -e .
community-domo-cli --help

# alternate module invocation for local dev
python3 -m community_domo_cli --help

認証の設定（Ryuu セッション）

前提条件 — Domo CLI をインストールし、一度ログインします：

npm install -g ryuu
domo login -i modocorp.domo.com

次に、コマンドを実行する前に環境変数を設定します：

export DOMO_INSTANCE=modocorp
export DOMO_AUTH_MODE=ryuu-session
community-domo-cli datasets list

トークン認証は非推奨です。 auth_mode=token は community-domo-cli でサポートされなくなりました。「Token auth mode is no longer supported」と表示された場合は、もう一度 domo login -i <instance> を実行し、DOMO_AUTH_MODE=ryuu-session を維持してください。

  • CLI は ~/.config/configstore/ryuu/<instance>.json からログインファイルを読み込みます
  • domo login の更新／セッション動作を再利用します

重要な実装上の制約

  • 製品 API のベース URL は https://<instance>.domo.com/api です（CLI がすでに /api を処理します）。
  • 削除操作はサポートされていません。
  • raw パススルーコマンドはありません。
  • ペイロードを検証する場合は、変更を伴う操作に先立って --dry-run を使用してください。

サポートされているコマンドの範囲（現行）

datasets
  • datasets list
  • datasets schema <dataset_id>
  • datasets sql <dataset_id> --body/--body-file
appdb
  • appdb collections
  • appdb collection-get <collection_id>
  • appdb document-create <collection_id> --body/--body-file
code-engine
  • code-engine get-package <package_id>
  • code-engine create-package --body/--body-file
  • code-engine update-version <package_id> <version> --body/--body-file
workflows
  • workflows get <workflow_id>
filesets
  • filesets get <fileset_id>
  • filesets file-get <fileset_id> <file_id>
  • filesets upload <fileset_id> --body/--body-file
  • filesets download <fileset_id> <file_id> --output <path>

トラブルシューティングのチェックリスト

  1. 呼び出し形式を確認します：
    • community-domo-cli ... を優先してください
    • python3 -m community_domo_cli ... は主にコントリビューターによるローカルテスト用です
    • python3 community_domo_cli ... は実行しないでください
  2. 認証情報を確認します：
    • DOMO_INSTANCE と DOMO_AUTH_MODE=ryuu-session が設定されていること
    • 対象のインスタンスで domo login が正常に実行されていること
  3. 識別子の種類を確認します：
    • datasets コマンドには dataset UUID
    • filesets コマンドには fileset UUID と file UUID
  4. 400／404 エラーが発生した場合は、まず正常に動作することが分かっている GET を再試行します：
    • datasets list
    • appdb collections
  5. 変更を伴う呼び出しでは、実際に実行する前に --dry-run でペイロードを検証します。

このプロジェクトでの回答スタイル

  • 簡潔で具体的にしてください。
  • 抽象的な指示ではなく、正確なコマンドを提示してください。
  • まず直接的な修正コマンドを示し、その後に簡単な説明を添えてください。

コメント

Markdown 対応