更新Readme文件

This commit is contained in:
xintaofei
2026-03-17 15:50:28 +08:00
parent f517f4fcbb
commit db4ff9d1ae
10 changed files with 803 additions and 174 deletions
+86 -21
View File
@@ -2,6 +2,8 @@
[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../LICENSE)
[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)
<p>
<a href="../../README.md">English</a> |
@@ -16,75 +18,138 @@
<a href="./README.ar.md">العربية</a>
</p>
Codeg(Code Generation)は、複数 Agent 向けのエンタープライズ級コード生成ワークスペースです。
Claude Code、Codex CLI、OpenCode、Gemini CLI などのローカル AI コーディング Agent を 1 つのデスクトップアプリに統合し、セッション集約、並列 `git worktree` 開発、MCP/Skills 管理、Git/ファイル/ターミナル連携を提供します。
Codeg(Code Generation)は、エンタープライズ級のマルチ Agent コーディングワークスペースです。
Claude Code、Codex CLI、OpenCode、Gemini CLI、OpenClaw などのローカル AI コーディング Agent を
1 つのデスクトップアプリに統合し、セッション集約、並列 `git worktree` 開発、MCP/Skills 管理、
Git/ファイル/ターミナル連携ワークフローを提供します。
## メインインターフェース
![Codeg Light](../images/main-light.png#gh-light-mode-only)
![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
## セッションタイル表示
![Codeg Light](../images/main2-light.png#gh-light-mode-only)
![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)
> 現在のバージョン: `v0.1.x`(高速に改善中)
> 現在のステータス: `v0.1.x`(高速イテレーション中、アーリーアダプター向け)
## 主な特長
## ハイライト
- 同一プロジェクトでのマルチ Agent 統合ワークスペース
- ローカルセッションの集約と構造化表示
- `git worktree` による並列開発
- MCP 管理(ローカルスキャン + 検索/インストール)
- Skills 管理(グローバル/プロジェクト)
- ファイルツリー、Diff、Git、コミット、ターミナルの一体化
- ローカルセッションの取り込みと構造化レンダリング
- 内蔵 `git worktree` フローによる並列開発
- MCP 管理(ローカルスキャン + レジストリ検索/インストール)
- Skills 管理(グローバルおよびプロジェクトスコープ)
- 統合エンジニアリングループ(ファイルツリー、Diff、Git 変更、コミット、ターミナル)
## 対応範囲
### 1) セッション取り込み(履歴)
### 1) セッション取り込み(履歴セッション)
| Agent | 環境変数優先パス | macOS / Linux 既定 | Windows 既定 |
| Agent | 環境変数パス | macOS / Linux デフォルト | Windows デフォルト |
| --- | --- | --- | --- |
| Claude Code | `$CLAUDE_CONFIG_DIR/projects` | `~/.claude/projects` | `%USERPROFILE%\\.claude\\projects` |
| Codex CLI | `$CODEX_HOME/sessions` | `~/.codex/sessions` | `%USERPROFILE%\\.codex\\sessions` |
| OpenCode | `$XDG_DATA_HOME/opencode/opencode.db` | `~/.local/share/opencode/opencode.db` | `%USERPROFILE%\\.local\\share\\opencode\\opencode.db` |
| Gemini CLI | `$GEMINI_CLI_HOME/.gemini` | `~/.gemini` | `%USERPROFILE%\\.gemini` |
| OpenClaw | — | `~/.openclaw/agents` | `%USERPROFILE%\\.openclaw\\agents` |
> 注: 環境変数はフォールバックパスより優先されます。
### 2) ACP リアルタイムセッション
20 以上の Agent アダプターを内蔵(Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw など)。
内蔵レジストリには、Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw、GitHub Copilot、Cline、Qwen Code など 20 以上のアダプターが含まれています。
### 3) Skills 設定対応
### 3) Skills 設定サポート
- 対応済み: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
- 他 Agent は順次追加予定
- 他のアダプターは順次追加予定
### 4) MCP ターゲットアプリ
現在の書き込み対象:
- Claude Code
- Codex
- OpenCode
## クイックスタート
### 要件
### 必要条件
- Node.js `>=22`
- Node.js `>=22`(推奨)
- pnpm `>=10`
- Rust stable(2021 edition)
- Tauri 2 のビルド依存
- Tauri 2 ビルド依存パッケージ
### 開発コマンド
Linux(Debian/Ubuntu)の例:
```bash
sudo apt-get update
sudo apt-get install -y \
libwebkit2gtk-4.1-dev \
libayatana-appindicator3-dev \
librsvg2-dev \
patchelf
```
### 開発
```bash
pnpm install
# デスクトップアプリ全体(Tauri + Next.js)
pnpm tauri dev
# フロントエンドのみ
pnpm dev
# フロントエンド静的エクスポート(out/ へ)
pnpm build
# デスクトップビルド
pnpm tauri build
# Lint
pnpm eslint .
# src-tauri/ で実行
# Rust チェック(src-tauri/ で実行)
cargo check
cargo clippy
cargo build
```
## アーキテクチャ
```text
Next.js 16 (Static Export) + React 19
|
| invoke()
v
Tauri 2 Commands (Rust)
|- ACP Manager
|- Parsers (local session ingestion)
|- Git / File Tree / Terminal runtime
|- MCP marketplace + local config writer
|- SeaORM + SQLite
|
v
Local Filesystem / Local Agent Data / Git Repos
```
## 制約事項
- フロントエンドは静的エクスポートを使用(`output: "export"`)
- Next.js の動的ルート(`[param]`)は不可。代わりにクエリパラメータを使用
- Tauri コマンドパラメータ: フロントエンドは `camelCase`、Rust は `snake_case`
- TypeScript strict モード
## プライバシーとセキュリティ
- 解析、ストレージ、プロジェクト操作はデフォルトでローカルファースト
- ネットワークアクセスはユーザーが明示的に操作した場合のみ発生
- エンタープライズ環境向けのシステムプロキシサポート
## ライセンス
Apache-2.0。`LICENSE` を参照してください。