Tissue CLI

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         # 非対話 (token)
tissue configure --method account --email user@example.com --password ...  # 非対話 (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       # => ./tissue にビルド
task test:cli    # => go test -v -count=1 ./cmd/tissue

トラブルシュート

• 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 を再実行。

関連リソース

• ライブラリ API: リポジトリルートの README.md
• REST API 仕様: doc/openapi.json
• scraping 版実装: client.go ほかルート .go ファイル
• token 版実装: api/ ディレクトリ