Getting Started

Quincyは、Amazon Q CLIプロセスの管理とプロジェクト管理のためのモダンなツールです。フロントエンドにAngular 20、バックエンドにHono frameworkを使用しています。

前提条件

• Node.js 20+
• pnpm 8+
• Git

インストール

1. リポジトリをクローンします：

git clone https://github.com/mzkmnk/quincy.git
cd quincy

2. 依存関係をインストールします：

pnpm install

開発環境の起動

バックエンドの起動

pnpm dev:backend

バックエンドサーバーは http://localhost:3000 で起動します。

フロントエンドの起動

pnpm dev:frontend

フロントエンドアプリケーションは http://localhost:4200 で起動します。

全体の起動

両方を同時に起動するには：

pnpm dev:backend & pnpm dev:frontend

プロジェクト構成

quincy/
├── apps/
│   ├── backend/          # Honoフレームワークを使用したAPI
│   ├── frontend/         # Angular 20アプリケーション
│   └── docs/            # VitePressドキュメント
├── packages/            # 共有パッケージ
└── pnpm-workspace.yaml  # ワークスペース設定

主な機能

Amazon Q CLI管理

• CLIプロセスの起動・停止・監視
• プロセス状態のリアルタイム表示
• エラーハンドリングと復旧機能

プロジェクト管理

• 複数プロジェクトの一元管理
• プロジェクト間の切り替え
• 設定ファイルの管理

チャット機能

• リアルタイムメッセージング
• WebSocket通信
• 入力状態の表示

API エンドポイント

詳細なAPI仕様については、API Referenceを参照してください。

トラブルシューティング

ポートが使用中の場合

デフォルトポートが使用中の場合は、環境変数で変更できます：

PORT=3001 pnpm dev:backend

依存関係のトラブル

依存関係に問題がある場合は、クリーンインストールを試してください：

rm -rf node_modules pnpm-lock.yaml
pnpm install

次のステップ

• API Reference - バックエンドAPIの詳細
• Frontend Components - フロントエンドコンポーネントの使用方法