Skip to content

tagru use ​

各コマンドで使うワークスペースを選び、接続先ごとに保存します。

text
tagru use [<workspace-id>] [--clear] [--target <prod|test|localhost>] [--json]

オプション ​

オプション内容
<workspace-id>選ぶワークスペースの ID(参加中のものだけ)
--clear選択を解除する(<workspace-id> とは同時に指定できません)
-t, --target <name>接続先
--jsonJSON で出力する

使い方 ​

bash
tagru use                  # 参加中のワークスペースを一覧表示する(選択中のものに * が付く)
tagru use ws-xxxx          # 操作するワークスペースを選んで保存する
tagru use --clear          # 選択を解除する
text
$ tagru use
接続先: prod
選択中: (未選択)
  ID       名前          ロール
  ws-xxxx  サンプル店舗  オーナー
  ws-yyyy  サンプル企画  メンバー

`tagru use <ID>` で選べます。

$ tagru use ws-xxxx
ワークスペースを サンプル店舗(ws-xxxx)に切り替えました(接続先: prod)。

$ tagru use --clear
ワークスペースの選択を解除しました(接続先: prod)。
  • 選んだワークスペースは接続先(prod / test / localhost)ごとに設定ファイル(config.json)へ保存します
  • 各コマンドの --workspace <id> は、保存した値より優先します
  • 参加していない ID を指定すると 参加中のワークスペースに見つかりません: … のエラー(終了コード 1)になります
  • ワークスペースを選んでいないときは、各コマンドはワークスペースに属さない個人のデータを表示します

--json ​

一覧(引数なし)は一覧の外枠で、各項目に選択中かどうか(selected)を加えます。

json
{
  "target": "prod",
  "workspaceId": "ws-xxxx",
  "items": [
    { "id": "ws-xxxx", "name": "サンプル店舗", "role": "owner", "selected": true },
    { "id": "ws-yyyy", "name": "サンプル企画", "role": "member", "selected": false }
  ],
  "count": 2,
  "hasMore": false
}
項目型内容
idstringワークスペース ID
namestring名前
rolestringowner / admin / member
selectedboolean選択中か
  • tagru use <workspace-id> --json: 詳細の外枠で、item に選んだワークスペース { id, name, role } を出します
  • tagru use --clear --json: { "target": "prod", "workspaceId": null } を出します

関連 ​