TAGRU CLITAGRU

表示モード

AI エージェントから使う ​

Claude Code / Codex などの AI エージェントに tagru を使わせるときは、tagru-cli に同梱の skill（SKILL.md）を入れます。 skill には、ログインの確かめ方・ワークスペースの選び方・コマンドの一覧・--json の読み方・エラーの対処・CLI からできないことが書かれています。

1. ログインする（利用者が行う） ​

ログインはブラウザでの許可が必要なので、エージェントだけでは完了できません。先に利用者がログインしておきます。

bash
tagru login
tagru use ws-xxxx      # 必要なら、操作するワークスペースを選んでおく

2. skill を入れる ​

bash
tagru skill install                    # Claude Code 用: ~/.claude/skills/tagru/SKILL.md
tagru skill install --agent codex      # Codex 用: ~/.codex/skills/tagru/SKILL.md
tagru skill install --agent all        # 両方
tagru skill install --project          # 今のディレクトリの .claude/skills/tagru/ に入れる（そのプロジェクトだけで使う）
text
$ tagru skill install
入れました: /home/user/.claude/skills/tagru/SKILL.md
  • skill は CLI に同梱した、CLI と同じバージョンのものです。ネットワークからは取得しません。ログインは不要です
  • 中身を確かめるときや、ほかのエージェント・場所に置くときは tagru skill show > SKILL.md で書き出せます
  • CLI を更新したら、もう一度 tagru skill install を実行して skill も更新してください（内容が変わっていれば上書きの確認が出ます。--yes で確認なし）
  • 削除は tagru skill uninstall（--agent / --project は install と同じ）

オプションと --json の項目は tagru skill を参照してください。

3. エージェントに頼む ​

skill を入れると、エージェントは TAGRU の話題（投稿・下書き・戦略・週次分析・分析指標・日次提案など）で skill を読み、 tagru ... --json で情報を取得します。例:

  • 「今週の予約投稿を確認して」→ tagru posts --scheduled --json
  • 「今日の日次提案を要約して」→ tagru daily --json
  • 「先週の週次分析の振り返りを見せて」→ tagru strategy --json
  • 「ヒアリングを進めて戦略の柱を決めたい」→ tagru interview start --json / answer / finish（質問への答えは利用者に聞き、確定の前に最終案を見せて確認を取る）

skill では、書き込み（ワークスペースの作成・ヒアリング・下書きの作成）は利用者に頼まれたときだけ実行するよう、エージェントに指示しています。

エージェントから使うときの性質 ​

  • --json を付けると、項目名を固定した JSON を標準出力に出します（出力形式）
  • 失敗すると終了コード 1 で終わり、--json のときはエラーも JSON（{ "error": { "status", "code", "message" } }）で標準エラー出力に出します（エラーと終了コード）
  • 投稿・予約投稿・ワークスペースの削除は CLI から行えないため、エージェントに任せても実行されません（CLI からできないこと）
  • ヒアリングの確定（tagru interview finish）は今の戦略を上書きします。端末でない環境では --yes が無いと失敗します。--yes を付けるのは、最終案を利用者に見せて確認を取ってからにしてください（skill でもそう指示しています）
  • 下書きの作成（tagru drafts create）は AI で本文を生成し、実行前に確認します。端末でない環境では --yes が無いと失敗します。--yes を付けるのは、利用者に頼まれたときだけにしてください（skill でもそう指示しています）
  • ヒアリングの対話モード（tagru interview / resume）は端末でだけ動きます
  • tagru skill install は、端末でない環境（エージェントからの実行など）では上書きの確認ができないため、内容の違う skill があると --yes なしでは終了コード 1 で終わります