codeg: Instructions file for Codex

AGENTS.md

This file provides guidance to Code Agent when working with code in this repository.

项目概述

Codeg（Code Generation）是一个多智能体编码工作台，它将多个智能体（Claude Code、Codex CLI、OpenCode、Gemini CLI、OpenClaw、Cline 等）统一到一个工作区中，支持会话聚合和多智能体协作，支持桌面安装，服务器/Docker 部署。

技术栈

• 桌面运行时: Tauri 2（Rust 后端 + webview 前端）
• 服务器运行时: 独立 Rust 二进制（Axum HTTP + WebSocket）
• 前端: Next.js 16（静态导出模式）+ React 19 + TypeScript（strict）
• 样式: Tailwind CSS v4 + shadcn/ui（radix-maia 风格）
• 国际化: next-intl
• 数据库: SeaORM + SQLite
• 包管理器: pnpm

代码检查与测试（任务完成后进行必要的检查）

前端

pnpm lint .                    # lint
pnpm test                      # vitest 全跑（CI 用同一条命令）
pnpm test:watch                # 开发时增量重跑
pnpm test:coverage             # 覆盖率报告（输出到 coverage/index.html）
pnpm build                     # 静态导出构建

后端 Rust（在 src-tauri/ 目录下执行）

# 桌面模式（默认 feature）
cargo check
cargo test --features test-utils
cargo clippy --all-targets --features test-utils -- -D warnings

# 服务器模式
cargo check --no-default-features --features server-bin --bin codeg-server
cargo test --no-default-features --features server-bin --bin codeg-server --lib
cargo clippy --no-default-features --features server-bin --bin codeg-server --lib -- -D warnings

# codeg-mcp 协作伴生进程（多智能体委托）
cargo check --no-default-features --features mcp-bin --bin codeg-mcp
cargo clippy --no-default-features --features mcp-bin --bin codeg-mcp -- -D warnings

# 解析器快照评审（输出变化时）
cargo insta review
INSTA_UPDATE=auto cargo test --features test-utils     # 自动写新 .snap

架构

双模式运行

项目通过 Cargo feature flags 支持三种二进制：

• codeg（tauri-runtime，默认）：完整桌面应用，包含 Tauri 窗口管理、系统通知、自动更新等
• codeg-server（--no-default-features --features server-bin）：独立服务器模式，仅编译 Axum HTTP API + WebSocket
• codeg-mcp（--no-default-features --features mcp-bin）：per-launch stdio MCP 伴生进程，被注入到代理 CLI 的 MCP 配置中，向 LLM 暴露异步子智能体委托工具。

后两个（以及 codeg-computer-helper 的 computer-helper）各要一个默认不开的 feature：Tauri CLI 会把所有 feature 已开的二进制目标打进桌面安装包，不开就不进包。