tagru drafts

投稿案（下書き）の一覧と、1 件の全文を表示します。create で、AI が下書きを 1 件作成します。

text

tagru drafts [list] [--limit <n>] [--workspace <id>] [--target <prod|test|localhost>] [--json]
tagru drafts get <draft-id> [--workspace <id>] [--target <prod|test|localhost>] [--json]
tagru drafts create [<今日やったこと>] [--instruction <AI への追加指示>] [--image] [--yes] [--workspace <id>] [--target <prod|test|localhost>] [--json]

サブコマンド

サブコマンド	内容
`list`（省略可）	下書きの一覧（更新日時の新しい順）。`tagru drafts` は `tagru drafts list` と同じです
`get <draft-id>`	下書き 1 件の全文
`create [<今日やったこと>]`	AI で下書きを 1 件作成する（書き込み）

オプション

オプション	内容
`--limit <n>`	件数（既定 20、1〜100）。`list` のみ
`--instruction <text>`	AI への追加指示（言い回し・訴求の角度・避けたい表現など）。`create` のみ
`--image`	本文に合わせた画像も AI で生成する。`create` のみ
`--yes`	確認せずに作成する。`create` のみ
`--workspace <id>`	ワークスペース（`tagru use` で保存した値より優先）
`-t, --target <name>`	接続先
`--json`	JSON で出力する

ワークスペースを選んでいない（tagru use も --workspace も無い）ときは、個人の下書きを表示します
下書きの削除と、投稿・予約は CLI からは行えません（TAGRU の画面から行ってください）

下書きの作成（create）

今日やったこと（投稿に必ず反映したい事実や活動）と、AI への追加指示をもとに、AI が下書きを 1 件作成します。 TAGRU の画面の「下書き投稿の作成」と同じ処理です。作成した下書きは TAGRU の画面と tagru drafts で確認できます。

今日やったこと（1 つ目の引数）か --instruction のどちらかが必要です。文章に空白を含むときは "…" で囲んでください
画像・動画の添付はできません（TAGRU の画面から行ってください）
ご利用のプランで下書きの作成を使えないときは エラー（403） になります（TAGRU の画面と同じ条件です）
書き込みのコマンドです。読み取りだけのログインだと エラー（403）: この操作には書き込みの権限がありません。… になります。tagru login --write でログインし直し、同意画面で書き込みを許可してください
AI で生成するため、--yes が無ければ端末で確認します（y/N）。端末でない環境（スクリプト・AI エージェントなど）では --yes が無いと失敗します（終了コード 1）

text

AI で下書きを生成するため、実行前に確認します。確認できない環境では --yes を付けて実行してください。

生成には時間がかかります（180 秒で打ち切り）。タイムアウト（network_error）でも、サーバーでは作成が進んでいることがあります。作り直す前に tagru drafts で作成されたか確かめてください
作成するだけで、投稿・予約はしません。公開は TAGRU の画面から行ってください

出力例

text

$ tagru drafts --limit 2
ワークスペース: ws-xxxx
ID          更新日時          タイトル            本文
draft-0002  2026-09-29 18:00  秋の新作の紹介      今日から店頭に並ぶ新作を 3 枚の写真で紹…
draft-0001  2026-09-27 10:00  週末のイベント告知  土曜日に店頭でワークショップを開きます。
ほか 10 件あります（--limit で増やせます）

`tagru drafts get <ID>` で全文を表示できます。

text

$ tagru drafts get draft-0002
ワークスペース: ws-xxxx
ID: draft-0002
タイトル: 秋の新作の紹介
作成日時: 2026-09-28 10:00
更新日時: 2026-09-29 18:00
ハッシュタグ: #秋コーデ #新作
画像・動画: 2 件
提案の理由: 新作の告知は保存されやすいため
画像・動画の指示: 店頭の棚に並んだ新作を正面から撮る
本文: 今日から店頭に並ぶ新作を 3 枚の写真で紹介します。

別のワークスペースの下書き ID を指定すると、下書きが見つかりません: … のエラー（404）になります。

text

$ tagru drafts create "新商品の試作をして、お客様3名に感想をもらった" --instruction "売り込み感は弱めに" --yes
ワークスペース: ws-xxxx
投稿案（下書き）を作成しました。
ID: draft-0003
画面で開く: https://app.example.com/workspace/ws-xxxx/dashboard?draftId=draft-0003

`tagru drafts get <ID>` で本文を表示できます。
公開（投稿・予約投稿）は TAGRU の画面から行ってください。

確認で y / yes 以外（空行を含む）を答えると、作成せずに 作成を取りやめました。 と出して終了コード 0 で終わります。

`--json`

tagru drafts --json は一覧の外枠（items）、tagru drafts get --json は詳細の外枠（item）で出します。

json

{
  "target": "prod",
  "workspaceId": "ws-xxxx",
  "item": {
    "id": "draft-0002",
    "title": "秋の新作の紹介",
    "text": "今日から店頭に並ぶ新作を 3 枚の写真で紹介します。",
    "hashtags": ["秋コーデ", "#新作"],
    "mediaCount": 2,
    "createdAt": "2026-09-28T10:00:00+09:00",
    "updatedAt": "2026-09-29T18:00:00+09:00",
    "why": "新作の告知は保存されやすいため",
    "mediaPrompts": ["店頭の棚に並んだ新作を正面から撮る"]
  }
}

項目	型	内容
`id`	string	下書きの ID（`tagru drafts get` に渡す）
`title`	string	タイトル
`text`	string	本文（一覧でも全文）
`hashtags`	string[]	ハッシュタグ（登録されたまま。テキストでは `#` を補って表示します）
`mediaCount`	number	添付した画像・動画の数
`createdAt`	string \| null	作成日時（ISO 8601）
`updatedAt`	string \| null	更新日時（ISO 8601）
`why`	string	提案の理由（`get` のみ）
`mediaPrompts`	string[]	画像・動画を作るときの指示（`get` のみ）

tagru drafts create --json は詳細の外枠（item）で、作成の結果だけを出します。本文は tagru drafts get <id> --json で取得してください。

json

{
  "target": "prod",
  "workspaceId": "ws-xxxx",
  "item": {
    "created": true,
    "id": "draft-0003",
    "openUrl": "https://app.example.com/workspace/ws-xxxx/dashboard?draftId=draft-0003"
  }
}

項目	型	内容
`created`	boolean	作成したか（確認で取りやめたら `false`）
`id`	string \| null	作成した下書きの ID（取りやめたら `null`）
`openUrl`	string \| null	作成した下書きを TAGRU の画面で開く URL（取りやめたら `null`）

tagru drafts ​

サブコマンド ​

オプション ​

下書きの作成（create） ​

出力例 ​

--json ​

tagru drafts

サブコマンド

オプション

下書きの作成（create）

出力例

`--json`