Prelaunch preview. Explore AROS products and skills. Checkout is in sandbox; no real payment.
← CohortDAG ドキュメント

AI エージェントやコマンドラインから CohortDAG を使う

操作ガイド · CohortDAG 0.2.9

CohortDAG には、コマンドラインツール cohortdag と MCP サーバー cohortdag-mcp が付属しており、ウィンドウと同じコンパイラーと Spark バックエンドを動かします。Claude Code、Codex、Google Antigravity などの AI エージェントは、これらを使って解析手順を作成し、検査し、実行します。開いているウィンドウにステップを加えるには、ウィンドウ上での承認が必要です。CohortDAG 自体には AI モデルは含まれず、エージェントはアプリの外で動いて、これらのツールでアプリを操作します。以下のコマンドはすべて、まっさらな Ubuntu 24.04 マシンに「はじめに」の手順で 0.2.4 のパッケージを入れて実際に実行したもので、表示されている出力はその実行結果です。

コマンド

コマンドを確認する

パッケージは cohortdag と cohortdag-mcp を PATH に追加します。バージョンを表示して確認します。

cohortdag --version
0.2.9

環境を確認する

Python、Java、PySpark、バックエンドを確認します。doctor は実際に Spark ドライバーを起動するので、少し時間がかかります。

cohortdag doctor
✓ Node.js: v24.22.2 (running this CLI)
  ✓ Python: Python 3.12.3 (/home/researcher/.config/cohortdag/python-env/bin/python -> /home/researcher/.config/cohortdag/python-env/bin/python)
  ✓ Java (JVM): openjdk version "17.0.21.0.3" 2026-10-24 (PATH)
  ✓ analysis packages (pyspark + production chain): pyspark 3.5.9; all required imports loaded
  ✓ backend (server.py): /opt/CohortDAG/resources/src/python/server.py
  ✓ Spark driver boot: a real SparkSession started and stopped
  ! data root: $COHORTDAG_DATA_ROOT not set
      fix: Set $COHORTDAG_DATA_ROOT to the directory holding your source parquet tables (only needed to run pipelines that read them).

Environment OK — the CohortDAG backend can run.

CohortDAG がつなげるエージェントを確認する

CohortDAG は、Claude Code、Codex(ChatGPT デスクトップアプリにも対応)、Google Antigravity に自分自身を登録できます。このコマンドは、各エージェントについて、CohortDAG の項目が存在するかしないかを一覧表示します。下の出力では、このマシンにはまだどのエージェントも設定されていないため、すべての項目がありません。エージェントを接続したあと、もう一度実行してください。cohortdag agent install --target all を実行すると、3 つのエージェントにスキルをまとめてインストールし、サーバーを登録します。そのあと各エージェントを再起動してください。ウィンドウの Help > Connect AI Agents… でも同じことができますが、一度に 1 つずつです。

cohortdag agent status
Claude Code: not detected (/home/researcher/.claude)
  claude-skill         absent     /home/researcher/.claude/skills/cohortdag-pipeline
  claude-mcp-plugin    absent     /home/researcher/.claude/skills/cohortdag
Google Antigravity: not detected (/home/researcher/.gemini/config)
  antigravity-plugin   absent     /home/researcher/.gemini/config/plugins/cohortdag
OpenAI Codex: not detected (/home/researcher/.codex)
  codex-skill          absent     /home/researcher/.codex/skills/cohortdag-pipeline

Claude Code とつなぐ

--dry-run と --force を付けずに実行すると、cohortdag-pipeline スキルがインストールされ、CohortDAG の MCP サーバーが登録されます。下の出力は --dry-run によるもので、書き込まれる内容(6 個のファイル)が表示されるだけで、何も変更されません。インストールするには、この 2 つを付けずに実行します。Claude Code を再起動し、チャット欄に /cohortdag-pipeline と入力して、自分の言葉で頼みます。たとえば「CohortDAG で入門用の生存分析の解析手順を作り、Spark で実行してください。」と依頼します。エージェントは解析手順のファイルを書き、検査し、CohortDAG 自身のコンパイラーと Spark バックエンドで実行します。Spark には Java と pyspark が必要で、cohortdag doctor は Node、Python、Java、pyspark を確認します。開いているウィンドウにステップを加えるには、そのステップを一覧にしたダイアログで承認する必要があります。断ることもできます。

cohortdag agent install --target claude-code --dry-run --force
Claude Code — would write 6 file(s):
  /home/researcher/.claude/skills/cohortdag-pipeline/SKILL.md
  /home/researcher/.claude/skills/cohortdag-pipeline/examples/minimal.csp
  /home/researcher/.claude/skills/cohortdag-pipeline/.cohortdag-managed.json
  /home/researcher/.claude/skills/cohortdag/.claude-plugin/plugin.json
  /home/researcher/.claude/skills/cohortdag/.mcp.json
  /home/researcher/.claude/skills/cohortdag/.cohortdag-managed.json

Codex または ChatGPT デスクトップアプリとつなぐ

これにより、スキルが ~/.codex の下にインストールされ、cohortdag サーバーが ~/.codex/config.toml に登録されます。同じインストールが、Codex のコマンドラインツールと ChatGPT デスクトップアプリの両方に使えます。お使いのほう(Codex または ChatGPT デスクトップアプリ)を再起動し、ChatGPT では @cohortdag-pipeline と入力して、Codex のコマンドラインツールでは /skills からスキルを呼び出し、上と同じように解析を頼みます。ChatGPT のウェブサイトはブラウザーで動くため、手元のコンピューターのプログラムには届かず、CohortDAG は使えません。

cohortdag agent install --target codex --dry-run --force
OpenAI Codex — would write 4 file(s):
  /home/researcher/.codex/skills/cohortdag-pipeline/SKILL.md
  /home/researcher/.codex/skills/cohortdag-pipeline/examples/minimal.csp
  /home/researcher/.codex/skills/cohortdag-pipeline/.cohortdag-managed.json
  /home/researcher/.codex/config.toml [key mcp_servers.cohortdag]

Google Antigravity とつなぐ

これにより、~/.gemini/config/plugins/cohortdag の下にプラグイン(スキルを含む)がインストールされ、cohortdag サーバーが ~/.gemini/config/mcp_config.json に登録されます。Antigravity を再起動すると、プラグインが Settings → Customizations に表示されます。そのあと、上と同じように解析を頼みます。

cohortdag agent install --target antigravity --dry-run --force
Google Antigravity — would write 5 file(s):
  /home/researcher/.gemini/config/plugins/cohortdag/plugin.json
  /home/researcher/.gemini/config/plugins/cohortdag/skills/cohortdag-pipeline/SKILL.md
  /home/researcher/.gemini/config/plugins/cohortdag/skills/cohortdag-pipeline/examples/minimal.csp
  /home/researcher/.gemini/config/plugins/cohortdag/.cohortdag-managed.json
  /home/researcher/.gemini/config/mcp_config.json [key mcpServers.cohortdag]

スターターの解析手順を一覧する

エージェントが出発点にできる解析手順を一覧表示します。

cohortdag pipelines list --kind starter

解析手順を確認する

実行する前に、解析手順ファイルの構造を確認します。ここでは同梱の生存解析スターターを使います。

cohortdag validate /opt/CohortDAG/resources/resources/templates/starter-survival.csp
valid

Spark で実行する

すべての出力を Apache Spark で実行し、セッションを結果ごと新しい .csp ファイルに保存します。このファイルはウィンドウで開けます。

cohortdag run /opt/CohortDAG/resources/resources/templates/starter-survival.csp --all-outputs --save-session survival.csp

レポートを書き出す

保存したセッションのレポートを Markdown で書き出します。

cohortdag report survival.csp --out report --format md
Wrote study report (4 file(s)) to report

解析手順をまとまりごとに読む

解析手順を、フェーズとそこに含まれるグループに分けて表示します。ここでは同梱の Bello-Chavolla の研究を使います。

cohortdag outline /opt/CohortDAG/resources/resources/templates/study-bello-chavolla-2020-mexico-cox.csp
Data sources (0 groups, 1 node)
Cohort definition (1 group, 3 nodes)
  Keep confirmed SARS-CoV-2 cases — 3 nodes: Recodes covariates and follow-up, keeps RESULTADO = 1; writes `bello_chavolla_confirmed_cohort`.
Descriptive results (2 groups, 4 nodes)
  Confirmed cohort mortality (n = 51,633) — 2 nodes: Reads the confirmed cohort back; reproduces Table 1 (5,332 deaths).
  Training cohort, 80% split (n = 41,307) — 2 nodes: Random 80% split stratified by mortality, as in the paper (seed 123).
Analysis (2 groups, 6 nodes)
  Survival by diabetes status — 2 nodes: Kaplan-Meier curves for known diabetes status; reproduces Figure 2.
  Table 2 Cox models — 4 nodes: Individual variables, the lethality score and its risk categories; reproduces Table 2.

解析手順のグループを提案させる

グループの提案を JSON で表示します。ファイルは変わりません。グループの名前を役割に合わせて付け直し、cohortdag groups apply で保存します。

cohortdag groups propose /opt/CohortDAG/resources/resources/templates/starter-survival.csp

グループが読みやすいか確認する

解析手順のグループの名前、大きさ、説明を確認します。指摘には直し方が付きます。同梱の研究には指摘がありません。

cohortdag groups lint /opt/CohortDAG/resources/resources/templates/study-bello-chavolla-2020-mexico-cox.csp --strict
no findings

ウィンドウでは、Help > Connect AI Agents… が cohortdag agent install と同じことを、エージェントごとに行います。