y-cli 🚀

y-agent

1つのエントリーポイントとクラウドワークスペース

スマートフォン、タブレット、デスクトップからタスクを引き継がせます。エージェントには同じクラウドワークスペースで作業してもらい、判断が必要になったときや作業内容を確認したいときに戻ってきます。

ワークスペースはEC2上に置き、y-agentを1つのエントリーポイントとして使っています。Telegramは同じシステムにアクセスする別の手段であり、独立したモバイルエージェントではありません。コード、メモ、タスクの記録、結果は、特定のチャットウィンドウに紐づくのではなく、自分のワークスペースに保管されます。デバイスを切り替えても、プロジェクトを一から説明し直す必要はありません。

詳しくはこちら：My AI Dev Setup: One Entry Point, a Cloud Workspace。

どのように連携するか

以下は、私のデプロイ環境を構成するレイヤーです。5つのサービスが直線的なパイプラインを形成しているわけではありません。

レイヤー	役割	私の環境
クライアント	タスクを引き継がせ、結果を読む	y-agentのWeb UI。Telegramはチャット入力インターフェースとして使用
メモリ	プロジェクトのコンテキストとタスクの状態を保持	EC2上のファイル、RDS上のPostgreSQLに保存された構造化レコード
ランタイム	コードを読み、ファイルを編集し、コマンドを実行	EC2上のClaude Code
ゲートウェイ	モデルリクエストを接続して転送	セルフホスト可能なリレー：claude-relay-serviceのフォーク
モデル	モデルの機能を提供	Claude / GPT / Grok

ファイルとデータベースのレコードは、作業に応じて読み書きされます。モデルリクエストのたびに必ず通過する中間地点ではありません。ランタイムとモデルの接続元は別々に選択できます。このリポジトリでエージェント機能を備えたCLIバックエンドはClaude Codeのみです。 その他のモデル接続元は、設定されたゲートウェイ、インターフェースの互換性、プロバイダーのサブスクリプション規約によって異なります。サブスクリプションがあれば、汎用APIを利用できるというわけではありません。リレーは別のサービスであり、y-agentには同梱されていません。推論のために、モデルのコンテキストは引き続きワークスペースの外部に送信されます。

内部では、React製のWeb UIとTelegramからFastAPI APIにアクセスします。APIはSQS経由で作業をキューに登録し、ワーカーがEC2のtmuxセッションでSSH経由でClaude Codeを起動して、結果をチャットの記録にストリーミングします。API、ワーカー、管理ジョブはAWS SAM/Lambdaでデプロイし、PostgreSQLで構造化された状態を管理します。ローカル開発ではSQSの代わりに、ファイルシステムブローカーを使用するCeleryを利用します。

できること

• コード以外も扱えるワークスペース。 Web と y CLI から、ToDo、メモ、リンク、カレンダー、メール、ドメインモジュールを扱えます。エージェントはコンテキストの別コピーではなく、同じファイルと記録を使用します。
• タスクにひも付いたコンテキスト。 ToDo に、議論、計画、進捗、レビューがつながります。新しいセッションでは、以前の会話全体をプロンプトに含めるのではなく、これらの情報を読み込みます。
• ランタイム外でのオーケストレーション。 小さなタスクなら1つのセッションで完了できます。大きなタスクは計画、実装、レビューの各セッションに分割でき、それぞれ必要なスキルを読み込みます。共有の trace_id でツリーをつなぎ、サブタスクのチャットも表示され、操作できます。
• 自分の対応を待つ受信トレイ。 awaiting は、判断、承認、または受け入れ確認が必要な作業を示します。公開の承認は、実装やレビューとは別の境界です。
• 拡張可能なインターフェース。 ホットロード可能なモジュールで、UI、API、CLI、データを追加できます。チャットでは、Mermaid の図、Vega-Lite のチャート、サニタイズされた SVG 成果物を表示できます。モジュールの仕様をご覧ください。
• MCP コネクター。 リモート HTTPS MCP サーバー（OAuth、静的ヘッダー、または認証なし。最初の対応プロバイダーは Alpha Vantage）に一度接続すると（OAuth は y mcp connect のループバックログイン経由）、ツールを明示的に承認できます。以降の Claude Code セッションでは、次回の起動時からこれらのツールを利用できます。認証情報は API 内で一元管理され、読み取り操作から返されることはありません。セッションには、起動時にスコープされたゲートウェイを通じて、承認済みのツールだけが公開されます。MCP コネクターの PRDと運用手順書をご覧ください。

実際のタスクのトレースをご覧ください。

始める

これは個人用のシステムであり、ホスティングサービスでもサポート対象の製品でもありません。一般公開やサードパーティによるデプロイはサポートされていません。

自分でデプロイしたい上級ユーザーの方は、このプロジェクトをすぐに使えるインストールガイドではなく、参考資料としてご利用ください。コードとインフラを自分の環境に合わせて変更し、ご自身で保守する必要があります。

ドメインモジュールは別の y-module リポジトリにあり、そのソースと公開済みバンドルはこのチェックアウトに含まれていません。バックアップ、権限、プロバイダーへのアクセス、インフラの保守は、ご自身で管理してください。

その他

• CHANGELOG：リリース履歴。
• y-agent の以前の紹介記事：背景と設計上の根拠。
• 以前は y-cli でした。y-cli はモデル API をラップし、y-agent はコーディングエージェントをラップします。