codeg CLAUDE.md

Repository instructions for Codeg, a desktop and server workspace that combines several coding assistants. They describe its Rust and Next.js technology, SQLite database, package manager, project structure, and required checks.

In plain words
What is it for?
Use them when changing Codeg’s frontend, Rust backend, database, desktop application, server, or multi-agent collaboration process.
Why use it?
They help an agent place changes correctly across the web, Rust, and collaboration code. They also define tests, linting, builds, and checks for both desktop and server modes.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/xintaofei/codeg/claude-md
Clone the repo
git clone --depth 1 https://github.com/xintaofei/codeg
Per session 1,632 This file is loaded in full into every session.
When invoked 1,632 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin 98% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01632 $0.01632
Opus 5 $0.00816 $0.00816
Sonnet 5 $0.00326 $0.00326
Haiku 4.5 $0.00163 $0.00163

Measured 2d ago against content hash 09ae1d819c54, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

codeg CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

98% identical to codeg AGENTS.md — 4 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 122 lines

How it starts

The opening of the file, as written. The whole thing — 122 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) 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 eslint .                  # 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 --bin codeg-server
cargo test --no-default-features --bin codeg-server --lib
cargo clippy --no-default-features --bin codeg-server --lib -- -D warnings

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

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

架构

双模式运行

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

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

共享核心

  • app_state.rsAppState 共享状态结构,两种模式通过 EventEmitter 枚举区分事件发射方式
  • web/event_bridge.rsEventEmitter::Tauri(AppHandle)EventEmitter::WebOnly(Arc<WebEventBroadcaster>)
  • web/router.rs — Axum 路由,接受 Arc<AppState>
  • web/handlers/ — HTTP API 端点,全部使用 Extension<Arc<AppState>>

Read the full file on GitHub · 122 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 122 lines · 1,632 tokens per session scan A 09ae1d819c54

Subscribe to this mod's changes

codeg CLAUDE.md is an instructions file published in the GitHub repository xintaofei/codeg (3,091 stars, last pushed today), licensed Apache-2.0. It adds 1,632 tokens to every session, about $0.0082 per session on Opus 5. A static security scan graded it A with 0 findings. It is 98% identical to codeg AGENTS.md, differing in 4 lines, and is treated as a copy.

Related

Other instructions, from other repositories