vyline: Instructions file for Codex

AGENTS.md — Vyline エージェント向けガイド

最終更新: 2026-11-03

このファイルは AI エージェントが Vyline プロジェクトを理解しタスクを実行するための包括的なガイドです。

---

プロジェクト概要

Vyline は LINE のサードパーティクライアントです。Bun + Hono + React で構築され、自前の LINE プロトコルスタック (@vyline/protocol) を持ちます。

• 目標: LINE にログインし、メッセージの送受信・Flex/Rich 表示・テーマカスタマイズを行う
• ライセンス: MIT License（logo/ のブランド資産は logo/LICENCE に従う CC BY 4.0）
• ステータス: Phase 0-3 完了。Beta 向けの UI・品質・配布準備とオープンチャット統合を継続中
• 外部依存: @evex/linejs なし。Thrift 型は @vyline/line-types（vendored）

---

最初に読む順番

この repository は README、docs、submodule、workspace が多い。迷った場合は次の順番で読む。

1. AGENTS.md（このファイル）
2. docs/README.md
3. docs/onboarding.md
4. docs/architecture.md
5. 対象機能に一番近い docs
6. 実コード

README はユーザー向け入口。実装判断の正本にしない。

AI が手間取りやすい点

• Vyline/packages/protocol、Vyline/packages/plugin、Vyline/packages/themes、tools は submodule/workspace の境界が見えにくい。まず bun run vyl:doctor で状態を確認する。
• docs整理では既存docsをテンプレートへ機械的に当て直さない。新規docsや大改修だけ docs/templates/ を使い、既存docsは必要箇所だけ直す。
• ドキュメントサイトは docs/ と Vyline/docs/ の Markdown を Vyline/website/site-data.js の documents に登録して生成する。掲載済みページの本文は元の Markdown から毎回生成されるため、サイト用に本文を複製しない。掲載ページを追加・削除・改名したときは documents の登録も同じ変更に含め、タイトル・カテゴリ・概要を更新する。
• ドキュメントを変更したら bun run docs:site で生成できることを確認する。生成物 dist-landing/ はコミットせず、main への反映後は .github/workflows/pages.yml がサイトを自動ビルド・デプロイする。サイトのビルド・デプロイ設定を変える場合は、同workflowのPRチェックも通す。
• README の正本は日本語が README.src.md、英語が README.en.src.md。README.md / README.en.md は生成物なので、原則として直接編集しない。README変更は両方の source に同じ内容を反映し、bun run docs:readme で生成して差分を確認する。
• README は元の構成を守る。新導線を入れる場合も、該当セクションへの追記に留める。
• 日本語と英語の README は情報量を揃える。機能、注意事項、パートナー、References、導入手順などを片方だけに追加しない。生成後は README.md と README.en.md の見出し・主要項目に欠落がないか確認する。
• vyl doctor / vyl init は軽い入口にする。npm publish、Docker build、Trivy container scan、full security scan は通常CLIに入れない。
• 重い処理は GitHub Actions の manual workflow、release workflow、schedule に寄せる。PRでは軽量チェックを優先する。

---

参照元・検索ツール

検索ツール: RPC_DICTIONARY

Vyline/packages/protocol/src/dictionary/rpcMap.ts — LINE.js 名 → Desktop 証拠 → Vyline 実装の対応表。