tagru assets

素材（ロゴ・商品画像・カタログなど）の一覧と、1 件の詳細を表示します。create で、手元のファイルを名称をつけて追加します。追加した素材は、TAGRU の画面（TAGRU / TAGRU Ads の「素材」）と同じものです。種類（ロゴ・商品写真・料金表など）・説明・料金表などの要点は、追加のときに TAGRU の AI がファイルの中身を見て付けます（編集はできません）。AI は名称と説明をもとに、生成に合う素材を探します。

text

tagru assets [list] [--workspace <id>] [--target <prod|test|localhost>] [--json]
tagru assets get <asset-id> [--workspace <id>] [--target <prod|test|localhost>] [--json]
tagru assets create <file> --name <名称> [--workspace <id>] [--target <prod|test|localhost>] [--json]

サブコマンド

サブコマンド	内容
`list`（省略可）	素材の一覧（作成日時の新しい順）。`tagru assets` は `tagru assets list` と同じです
`get <asset-id>`	素材 1 件の詳細（説明の全文）
`create <file>`	ファイルを素材として 1 件追加する（書き込み）

オプション

オプション	内容
`--name <text>`	名称（必須、30 文字以内）。ブランド名・商品名など、ファイルを見ても分からないことを入れます。`create` のみ
`--workspace <id>`	ワークスペース（`tagru use` で保存した値より優先）
`-t, --target <name>`	接続先
`--json`	JSON で出力する

ワークスペースを選んでいない（tagru use も --workspace も無い）ときは、個人の素材を表示・追加します
--workspace は、そのコマンドだけに使います。tagru use で保存した選択は変わりません
素材は、個人・ワークスペースごとに 20 件まで登録できます（--limit はありません）
素材の削除は CLI からは行えません（TAGRU の画面から行ってください）。素材の編集・ファイルの差し替えは、画面を含めてどこからもできません。入れ替えるときは、画面で削除してから追加し直してください

素材の追加（create）

bash

tagru assets create ./logo.png --name "ACME カフェのロゴ"

追加できるファイルは JPEG（.jpg / .jpeg）・PNG（.png）・WebP（.webp）・PDF（.pdf）で、10 MB（10,485,760 バイト）以下です。拡張子からファイルの形式を判断して送ります
名称は 30 文字までです（前後の空白は除いて数えます）。ブランド名・商品名など、ファイルを見ても分からないことを入れてください。説明は TAGRU の AI が書くため、指定するオプションはありません
拡張子・サイズ・文字数は送る前にも確かめ、合わないときは通信せずに終了コード 1（usage_error）で終わります
ファイルの中身が拡張子と違う・アニメーション画像・20 件に達している、などはサーバーが判定してエラーにします（下の「エラー」）
書き込みのコマンドです。読み取りだけのログインだと エラー（403）: この操作には書き込みの権限がありません。… になります。tagru login --write でログインし直し、同意画面で書き込みを許可してください
追加のときに TAGRU の AI がファイルを読みます（種類・説明・要点。数秒かかります）。追加の前の確認はありません
複数ファイルを追加するときも、1 ファイルにつき 1 回 create を実行します。AI エージェントに依頼する場合は、ファイルごとの名称を利用者に確認し、推測で一括追加しないでください
追加前に、同じ保存先の tagru assets --json で登録済みの素材と残りの枠（20 − 登録数）を確認してください。依頼された件数に足りなければ、追加を始めず利用者に伝えてください
アップロードは 120 秒で打ち切ります。タイムアウト（network_error）でも、サーバーでは追加が済んでいることがあります。追加し直す前に tagru assets で確かめてください
tagru images で生成した画像は、手元のファイルを送り直さずに --save-as-asset --name <名称> で素材に登録できます（素材への登録）

出力例

text

$ tagru assets
ワークスペース: ws-xxxx
登録数: 2 / 20 件
ID          名称      形式   サイズ  更新日時          説明
asset-0002  カタログ  PDF    2.4 MB  2026-09-29 09:00  秋の商品カタログ
asset-0001  会社ロゴ  PNG   12.1 KB  2026-09-28 09:00  白背景の会社ロゴ。広告の右下に入れる

`tagru assets get <ID>` で説明の全文を表示できます。

text

$ tagru assets get asset-0001
ワークスペース: ws-xxxx
ID: asset-0001
名称: 会社ロゴ
形式: PNG
ファイル名: logo.png
サイズ: 12.1 KB
画素数: 1,200 x 800
作成日時: 2026-09-28 09:00
更新日時: 2026-09-28 09:00
説明: 白背景の会社ロゴ。広告の右下に入れる

PDF・画素数を読み取れない画像は、画素数 が (なし) になります。別のワークスペースの素材 ID を指定すると、素材が見つかりません: … のエラー（404）になります。

text

$ tagru assets create ./logo.png --name "会社ロゴ"
ワークスペース: ws-xxxx
素材を追加しました。
ID: asset-0003
名称: 会社ロゴ
形式: PNG
ファイル名: logo.png
サイズ: 12.1 KB
画素数: 1,200 x 800
作成日時: 2026-09-30 10:00
更新日時: 2026-09-30 10:00
説明: 白い背景に黒い文字で「ACME」と書かれた横長のロゴ

`tagru assets` で一覧を確認できます。削除は TAGRU の画面から行ってください。

エラー

状況	表示（例）
対応していない拡張子（送らない）	`対応していないファイル形式です: anim.gif（JPEG / PNG / WebP / PDF のファイルを指定してください）。`
10 MB を超える（送らない）	`ファイルが大きすぎます: photo.jpg（12.3 MB）。10 MB（10,485,760 バイト）以下のファイルを指定してください。`
名称の文字数超過（送らない）	`--name は 30 文字以内で指定してください（31 文字）。`
ファイルが無い・空（送らない）	`ファイルが見つかりません: ./logo.png` / `空のファイルです: logo.png`
20 件に達している	`エラー（409）: API の呼び出しに失敗しました（HTTP 409 asset_limit_reached: 上限の20件に達しています。不要な素材を削除してください）。`
中身が拡張子と違う・アニメーション画像	`エラー（415）: …asset_invalid_format…`
サイズ超過（サーバーの判定）	`エラー（413）: …asset_file_too_large…`
名称の未入力など	`エラー（400）: …asset_invalid_input…`
参加していないワークスペース	`エラー（403）: …asset_forbidden…`

--json のときは、ほかのコマンドと同じく { "error": { "status", "code", "message" } } を標準エラー出力に出します（エラーと終了コード）。

`--json`

tagru assets --json は一覧の外枠（items）、tagru assets get --json と tagru assets create --json は詳細の外枠（item）で出します。 1 か所の素材は最大 20 件で、一覧は全件を返すため hasMore は常に false です。

json

{
  "target": "prod",
  "workspaceId": "ws-xxxx",
  "item": {
    "id": "asset-0001",
    "name": "会社ロゴ",
    "description": "白背景の会社ロゴ。広告の右下に入れる",
    "workspaceId": "ws-xxxx",
    "contentType": "image/png",
    "fileName": "logo.png",
    "size": 12345,
    "width": 1200,
    "height": 800,
    "createdAt": "2026-09-28T09:00:00+09:00",
    "updatedAt": "2026-09-28T09:00:00+09:00"
  }
}

項目	型	内容
`id`	string	素材の ID（`tagru assets get` に渡す）
`name`	string	名称
`description`	string	説明（TAGRU の AI が書いたもの）
`workspaceId`	string \| null	保存先のワークスペース ID（個人の素材は `null`）
`contentType`	string	形式（`image/jpeg` / `image/png` / `image/webp` / `application/pdf`）
`fileName`	string	追加したときのファイル名
`size`	number \| null	ファイルのサイズ（バイト）
`width`	number \| null	画像の幅（PDF・読み取れない画像は `null`）
`height`	number \| null	画像の高さ（PDF・読み取れない画像は `null`）
`createdAt`	string \| null	作成日時（ISO 8601）
`updatedAt`	string \| null	更新日時（ISO 8601）

ファイルの中身や URL は出力しません。中身は TAGRU の画面で確認してください。

tagru assets ​

サブコマンド ​

オプション ​

素材の追加（create） ​

出力例 ​

エラー ​

--json ​

tagru assets

サブコマンド

オプション

素材の追加（create）

出力例

エラー

`--json`