tagru posts

投稿・予約投稿の一覧を表示します。見るだけのコマンドです（投稿・予約はできません。CLI からできないこと）。

tagru posts [--scheduled] [--workspace <id>] [--limit <n>] [--target <prod|test|localhost>] [--json]

オプション

オプション	内容
--scheduled	今日から 8 日間の予約中の投稿を、予約日時の早い順に表示する
--workspace <id>	ワークスペース（tagru use で保存した値より優先）
--limit <n>	件数（既定 20、1〜100）
-t, --target <name>	接続先
--json	JSON で出力する

使い方

tagru posts                     # 投稿の一覧（作成日の新しい順）
tagru posts --scheduled         # 今日から 8 日間の予約中の投稿（予約日時の早い順）
tagru posts --limit 50 --json   # 件数を変える・JSON で出す

ワークスペースは --workspace <id> か tagru use で選んだものを使います。 どちらも無い場合は、ワークスペースに属さない個人の投稿を表示します。

出力例

$ tagru posts --limit 2
ワークスペース: ws-xxxx
ID         日時              媒体       状態    本文
post-0003  2026-09-30 18:00  Instagram  予約    秋の新作を先行公開します。店頭では来週…
post-0002  2026-09-28 12:00  X, TikTok  投稿済  本日のおすすめ
ほか 42 件あります（--limit で増やせます）

$ tagru posts --scheduled
ワークスペース: ws-xxxx
予約中の投稿（今日から 8 日間）
ID         日時              媒体       状態  本文
post-0003  2026-09-30 18:00  Instagram  予約  秋の新作を先行公開します。店頭では来週…

• 日時は予約日時（無ければ作成日時）です
• 状態は 下書き / 予約 / 処理中 / 投稿済 / 失敗 です

--json

一覧の外枠（出力形式）で出します。

{
  "target": "prod",
  "workspaceId": "ws-xxxx",
  "items": [
    {
      "id": "post-0003",
      "status": "scheduled",
      "platforms": ["instagram"],
      "scheduledAt": "2026-09-30T18:00:00+09:00",
      "createdAt": "2026-09-29T09:00:00+09:00",
      "updatedAt": "2026-09-29T09:00:00+09:00",
      "text": "秋の新作を先行公開します。店頭では来週から販売します。"
    }
  ],
  "count": 1,
  "hasMore": true
}

items の各項目:

項目	型	内容
id	string	投稿の ID
status	string	draft（投稿先の媒体が未選択）/ scheduled（予約中）/ pending（公開処理中）/ posted（投稿済み）/ failed（いずれかの媒体で失敗）
platforms	string[]	投稿先の媒体（instagram / x / tiktok / youtube / google_business / wordpress）
scheduledAt	string | null	予約日時（ISO 8601）
createdAt	string | null	作成日時（ISO 8601）
updatedAt	string | null	更新日時（ISO 8601）
text	string	本文（全文）

テキストの状態の表示との対応は、draft = 下書き、scheduled = 予約、pending = 処理中、posted = 投稿済、failed = 失敗です。