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 --version0.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 statusClaude 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-pipelineClaude 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 --forceClaude 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.jsonCodex または ChatGPT デスクトップアプリとつなぐ
これにより、スキルが ~/.codex の下にインストールされ、cohortdag サーバーが ~/.codex/config.toml に登録されます。同じインストールが、Codex のコマンドラインツールと ChatGPT デスクトップアプリの両方に使えます。お使いのほう(Codex または ChatGPT デスクトップアプリ)を再起動し、ChatGPT では @cohortdag-pipeline と入力して、Codex のコマンドラインツールでは /skills からスキルを呼び出し、上と同じように解析を頼みます。ChatGPT のウェブサイトはブラウザーで動くため、手元のコンピューターのプログラムには届かず、CohortDAG は使えません。
cohortdag agent install --target codex --dry-run --forceOpenAI 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 --forceGoogle 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.cspvalidSpark で実行する
すべての出力を 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 mdWrote study report (4 file(s)) to report解析手順をまとまりごとに読む
解析手順を、フェーズとそこに含まれるグループに分けて表示します。ここでは同梱の Bello-Chavolla の研究を使います。
cohortdag outline /opt/CohortDAG/resources/resources/templates/study-bello-chavolla-2020-mexico-cox.cspData 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 --strictno findingsウィンドウでは、Help > Connect AI Agents… が cohortdag agent install と同じことを、エージェントごとに行います。