| name | tissue-cli |
| description | Use when the user works with the `tissue` CLI (shikorism.net / Tissue). Triggers on requests to check in, list/search checkins, manage collections or collection items, view tag stats, fetch user info, or configure authentication (`tissue configure`, `tissue checkin`, `tissue collection`, `tissue me`, `tissue search`, `tissue tags`). Also applies when discussing the `cmd/tissue` reference CLI in this repository or debugging its behavior. |
tissue CLI
cmd/tissue は本リポジトリのリファレンス実装 CLI。認証方式は token (個人用アクセストークン) / account (Email + Password) の2種類。一部サブコマンドは認証方式によって利用可否が異なる。
インストール
go install github.com/mohemohe/go-tissue/cmd/tissue@latest
go build -o tissue ./cmd/tissue
設定 (tissue configure)
設定ファイルは $XDG_CONFIG_HOME/tissue/config.json (既定 ~/.config/tissue/config.json) に 0600 で保存される。対話/非対話の双方に対応。
tissue configure
tissue configure --method token --access-token YOUR_TOKEN
tissue configure --method account --email user@example.com --password ...
個人用アクセストークンは 設定 → 個人用アクセストークン で発行する。
サブコマンド早見表
| コマンド | 説明 | 対応認証 |
|---|
tissue me | 自分のユーザー情報 | token / account |
tissue checkin add | チェックイン作成 | token / account |
tissue checkin list | チェックイン一覧 | token / account |
tissue checkin get <id> | チェックイン詳細 | token のみ |
tissue checkin update <id> | チェックイン更新 | token のみ |
tissue checkin delete <id> | チェックイン削除 | token のみ |
tissue collection list | コレクション一覧 | token / account |
tissue collection create | コレクション作成 | token / account |
tissue collection update <id> | コレクション更新 | token / account |
tissue collection delete <id> | コレクション削除 | token / account |
tissue collection item list <cid> | アイテム一覧 | token / account |
tissue collection item add <cid> | アイテム追加 | token / account |
tissue collection item update <cid> <iid> | アイテム更新 | token / account |
tissue collection item delete <cid> <iid> | アイテム削除 | token / account |
tissue search "<query>" | チェックイン検索 | token / account |
tissue tags | 最近使用タグ | account のみ |
よく使うレシピ
チェックインする
tissue checkin add \
--tags a,b \
--link https://example.com \
--note "memo" \
--private
一覧・検索
tissue checkin list --user someone --page 1
tissue search "test"
チェックインを編集/削除 (token 認証のみ)
tissue checkin get 123
tissue checkin update 123 --note "fixed"
tissue checkin delete 123
コレクション操作
tissue collection list
tissue collection create --title "title" --private
tissue collection update 47 --title "new" --private
tissue collection delete 47
コレクションアイテム操作
update では変更対象フィールドを --set-* フラグで明示的に指定する（未指定フィールドは保持）。
tissue collection item list 47
tissue collection item add 47 --link https://example.com --note memo --tags a,b
tissue collection item update 47 2346 --set-note --note updated --set-tags --tags c
tissue collection item delete 47 2346
開発・テスト
リポジトリ内で CLI を触る場合:
task build
task test:cli
トラブルシュート
checkin get/update/delete が動かない: account 認証では非対応。tissue configure --method token ... でトークン認証に切り替える。tags が動かない: account 認証のみ対応。- 設定が読めない:
~/.config/tissue/config.json が存在してパーミッション 0600 になっているか確認。$XDG_CONFIG_HOME が設定されている環境ではそちらが優先される。
- 401 / 認証エラー: token の失効または Email / Password 変更を疑う。
tissue configure を再実行。
関連リソース
