tagru notifications

通知の設定を表示・変更します。通知の種類ごとに、通知一覧に残す（on）か、トーストだけ出す（off）かを、TAGRU の画面の通知の設定と同じ内容で読み書きします。

text

tagru notifications settings show [--workspace <id> | --personal] [--target <prod|test|localhost>] [--json]
tagru notifications settings set <kind>=<on|off> [<kind>=<on|off> ...] [--workspace <id> | --personal] [--target <prod|test|localhost>] [--json]

--personal は保存済みのワークスペース選択を変えず、この要求だけ個人の設定を対象にします。--workspace との併用は通信前のエラーです。省略時は従来どおり --workspace > 接続先ごとの保存済み選択 > 個人の順です。

サブコマンド

サブコマンド	内容
`settings show`	今の設定を表示する（読み取りの権限）
`settings set <kind>=<on\|off> ...`	指定した種類だけを変更し、保存後の設定を表示する（書き込みの権限）

オプション

オプション	内容
`<kind>=<on\|off>`	変更する種類と値（`set` のみ。1 つ以上。同じ種類は 1 回だけ）
`--workspace <id>`	ワークスペース（`tagru use` で保存した値より優先）
`--personal`	選択中のワークスペースを変えず、この要求だけ個人を対象にする（`--workspace` と併用不可）
`-t, --target <name>`	接続先
`--json`	JSON で出力する

--personal を省略した対象は --workspace > tagru use で選んだワークスペースの設定です。どちらも無いときは個人の設定です
--personal を指定せずワークスペースを選んでいると、set はそのワークスペースの設定（メンバー全員の通知に効く）を変えます。 個人の設定だけを変えるときは --personal を指定してください。保存済み選択そのものを解除したい場合は従来どおり tagru use --clear を使えます
どの設定を表示・変更したかは、出力の先頭の行（--json は外枠の workspaceId と item.scope）で確かめられます
種類は show で確認できます。個人は videoGeneration（動画の作成・編集）と dailyProposalImage（投稿案の画像生成）、ワークスペースはそれに customReportRebuild（カスタムレポートの作り直し）が加わります
set で指定しなかった種類は変わりません。変えたことのない種類は既定の値です
切り替えられない種類（知らない種類、個人の customReportRebuild）を指定すると、エラー（400） で何も変更しません
招待を承認していないワークスペースの設定は表示・変更できません
set には書き込みの権限が要ります。読み取りだけでログインしているときは tagru login --write でログインし直し、同意画面で書き込みを許可してください

使い方

bash

tagru notifications settings show                                # 今の設定を表示する
tagru notifications settings set dailyProposalImage=on           # 投稿案の画像生成も通知一覧に残す
tagru notifications settings set videoGeneration=off customReportRebuild=off --workspace ws-xxxx
tagru notifications settings set videoGeneration=off --personal   # 個人の設定を変える

出力例

text

$ tagru notifications settings show --workspace ws-xxxx
対象: ワークスペース ws-xxxx の設定（メンバー全員の通知に効きます）
種類                 名前                        設定                 既定
videoGeneration      動画の作成・編集            on（一覧に残す）     on
dailyProposalImage   投稿案の画像生成            on（一覧に残す）     off
customReportRebuild  カスタムレポートの作り直し  off（トーストだけ）  on

text

$ tagru notifications settings set dailyProposalImage=on --personal
個人の通知の設定を保存しました。
種類                名前              設定              既定
videoGeneration     動画の作成・編集  on（一覧に残す）  on
dailyProposalImage  投稿案の画像生成  on（一覧に残す）  off

ワークスペースの設定を変えたときの先頭の行は ワークスペース ws-xxxx の通知の設定を保存しました（メンバー全員の通知に効きます）。 です。

`--json`

--personal の外枠は workspaceId: null です。JSON の項目は変わりません。

1 件の外枠で、item は今のスコープの設定です（set は保存後の設定）。

json

{
  "target": "prod",
  "workspaceId": "ws-xxxx",
  "item": {
    "scope": "workspace",
    "kinds": [
      {
        "kind": "videoGeneration",
        "label": "動画の作成・編集",
        "description": "動画の作成・編集（投稿案カードからの動画を含む）が終わったとき・失敗したとき",
        "listed": true,
        "defaultListed": true
      }
    ],
    "updatedAt": "2026-11-01T00:00:00+00:00"
  }
}

項目	型	内容
`scope`	string	`personal`（個人）/ `workspace`（ワークスペース）
`kinds`	object[]	そのスコープで切り替えられる種類（画面と同じ並び）
`kinds[].kind`	string	種類の ID（`set` に渡す値）
`kinds[].label`	string	名前
`kinds[].description`	string	何が届くか
`kinds[].listed`	boolean	今の設定（`true` は通知一覧に残す、`false` はトーストだけ）
`kinds[].defaultListed`	boolean	既定の値
`updatedAt`	string \| null	最後に保存した日時。一度も保存していなければ `null`

tagru notifications ​

サブコマンド ​

オプション ​

使い方 ​

出力例 ​

--json ​

tagru notifications

サブコマンド

オプション

使い方

出力例

`--json`