terminaluse

TerminalUse

エージェントを構築、デプロイし、操作します。フロー：初期化 → デプロイ → タスク作成 → メッセージ送信。

ドキュメント全文：https://docs.terminaluse.com/llms-full.txt

新しいエージェントのデフォルトルール

新しいエージェントを作成するときは、デフォルトで tu init を使用してください。

ユーザーが別の方法を明示的に指示した場合（例：既存のエージェントテンプレートや、事前にひな形が作成されたリポジトリの変更）のみ、tu init を省略してください。

CLI のセットアップ

tu CLI は Python パッケージ terminaluse によって提供されます。tu コマンドを実行する前に、次の手順を行ってください。

1. tu が利用可能か確認します：

   which tu || echo "tu CLI not found"
   

2. インストールされていない場合、インストールするか、ソースを読み込む venv があるかをユーザーに尋ねてください

3. 認証が設定されていることを確認します：

   • 対話型／ローカル：tu login の後に tu whoami
   • 非対話型／自動化：TERMINALUSE_API_KEY を設定します（必要に応じて TERMINALUSE_BASE_URL も設定します）

コンテキスト要件

エージェントを対象とするコマンドでは、--agent／--config を省略すると、現在のディレクトリにある config.yaml がデフォルトで使われることがよくあります。

明示的なフラグを指定せずにエージェントを対象とするコマンドを実行する前に、次の手順を行ってください。

ls config.yaml || echo "Not in agent directory"

可能な場合は、明示的なフラグを使用してください：

• --agent <namespace/name> を指定して、ディレクトリへの依存を避けます
• 特定のマニフェストを扱う場合は --config <path> を指定します

クイックリファレンス

操作	コマンド
ログイン	tu login、tu whoami
エージェントを初期化	tu init（エージェントディレクトリを作成します。事前に mkdir を実行する必要はありません）
デプロイ	tu deploy -y
デプロイ一覧	tu ls
ロールバック	tu rollback
ファイルシステム一覧	tu fs ls
プロジェクト一覧	tu projects ls
環境変数を追加	tu env add <KEY> -v <val> -e prod|preview|all [--secret]
環境ファイルをインポート	tu env import <file> -e <env> [--secret KEY]
タスクを作成	tu tasks create --filesystem-id <fs-id> -m "message" [--json]
タスクを作成（ファイルシステムを自動作成）	tu tasks create -p <project-id> -m "message" [--json]
メッセージを送信	tu tasks send <task-id> -m "message" [--json]
タスク一覧	tu tasks ls [--json]
タスクの詳細を取得	tu tasks get <task-id>

tu fs がファイルシステムを操作する正式なコマンドです。tu filesystems はサポートされているエイリアスです。 tu tasks ls <id> による単一タスクの取得は非推奨です。代わりに tu tasks get <id> を使用してください。 CI／自動化およびエージェント間のやり取りでは、--json を優先してください。

ワークフロー

タスク	リファレンス
エージェントの作成または編集	./workflows/create.md
プラットフォームへのデプロイ	./workflows/deploy.md
エージェントのテスト／操作	./workflows/interact.md

ユーザーの意図に応じて、対応するワークフローファイルを確認する必要があります。

アンチパターン

• ファイルシステムまたはプロジェクトなしでタスクを作成すること。タスクにはファイルシステムが必要です。プロジェクトが指定されている場合は、そのプロジェクト内にファイルシステムが自動作成されます
• Dockerfile の ENTRYPOINT／CMD を変更すること → デプロイが失敗します
• シークレットを更新した直後にエージェントを使用しようとすること。新しいバージョンが有効になるまで待つ必要があります。tu ls で確認してください

エラーからの復旧

エラー	対処
デプロイに失敗	tu ls <branch> でブランチのデプロイイベントを一覧表示し、FAILED を見つけて修正し、再デプロイします
ロールバックが必要	tu rollback

ドキュメント／スキルへのフィードバック

ドキュメントやスキルに誤りや不明瞭な点がある場合は、フィードバックの送信許可をユーザーに求めてください（ユーザーのリクエストにフィードバックを含めてください）。 機密情報は絶対に含めないでください。

curl -X POST 'https://uutzjuuimuclittwbvef.supabase.co/functions/v1/tu-docs-feedback' \
  -H 'Content-Type: application/json' \
  -d '{"feedback":"<issue>", "page":"<page URL> or section name"}'