AI导哈

代码会话数据集转换工具

将Claude Code和Codex会话转换为隐私安全的训练数据集，支持审查关卡、后台同步和MCP内存检索。

  • by ychampion
  • Python
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 ychampion/codeclaw

使用说明

CodeClaw

CodeClaw将Claude Code和Codex会话转换为具有审查门、背景同步和MCP内存检索的隐私安全培训数据集。

太长，读不下去了

  • 跑 codeclaw setup 一次。
  • 跑 codeclaw export --no-push 生成本地审查数据集。
  • 跑 codeclaw confirm ... 通过审查门。
  • 跑 codeclaw export --publish-attestation "..." 只有在明确批准后。

默认用户体验

  • 跑步平原 codeclaw 打开全屏TUI。
  • 跑步 codeclaw export ... 保持脚本CLI流。

为什么选择CodeClaw

  • 将日常编码会话转化为结构化、可重用的培训数据。
  • 通过编辑和手动审查门保持一流的隐私控制。
  • 通过MCP可访问的会话内存保存历史问题解决上下文。

核心能力

  • 多源摄入：
    • Claude Code和Codex会话发现和解析。
    • Cursor、Windsurf、Aider、Continue.dev、Antigravity、VS Code、Zed和Xcode测试日志的实验适配器路由。
  • 隐私保护导出：
    • 机密和PII编辑、用户名匿名化和项目级排除。
    • 分层隐私引擎：正则表达式基线+可选ML NER(codeclaw[pii-ml]).
  • 受控发布工作流程：
    • 本地导出，用户审核证明，确认门，然后推。
    • 不可变数据集版本快照+发布时的重复数据消除索引。
  • 连续模式：
    • 用于增量同步的后台监视守护进程。
  • 内存工具：
    • MCP服务器，具有搜索、项目模式、轨迹统计、会话查找、图相似性检索和索引刷新功能。

安装

pip install codeclaw

可选附加功能：

pip install "codeclaw[pii-ml]"    # Presidio + spaCy detection layer
pip install "codeclaw[mcp]"       # MCP server runtime
pip install "codeclaw[finetune]"  # Experimental local fine-tune scaffolding

来源：

git clone https://github.com/ychampion/codeclaw.git
cd codeclaw
pip install -e ".[dev]"

检查安装版本：

codeclaw --version

快速开始

# Guided onboarding (HF auth help, repo setup, project scope, MCP, watcher)
codeclaw setup

# Reset local setup for a clean re-test (config/state/MCP entry)
codeclaw reset --all --yes

# Verify environment and connected scope
codeclaw doctor
codeclaw projects --source both
codeclaw stats
codeclaw diff --format json
codeclaw config --encryption status

# Export locally first
codeclaw export --no-push

# Review and confirm
codeclaw confirm \
  --full-name "YOUR FULL NAME" \
  --attest-full-name "Asked for full name and scanned export." \
  --attest-sensitive "Reviewed for company/client/private identifiers." \
  --attest-manual-scan "Manually reviewed representative sessions."

# Publish only after explicit approval
codeclaw export --publish-attestation "User explicitly approved publishing to Hugging Face."

# Optional one-command sharing flow
codeclaw share --publish --publish-attestation "User explicitly approved publishing to Hugging Face."

命令

命令 描述
codeclaw status 显示当前阶段和下一步（JSON）
codeclaw prep 发现项目和身份验证状态
codeclaw setup 引导入职（HF、数据集仓库、项目、MCP、观察者）
codeclaw doctor 验证日志、HF身份验证、MCP注册和运行时PATH/版本诊断
codeclaw stats 显示会话、令牌、编校和导出指标
codeclaw stats --skill 包括基于轨迹的增长指标
codeclaw diff 在确认之前，准确预览要编辑的内容
codeclaw projects 管理关联项目范围
`codeclaw reset [--all --config
codeclaw list 列出具有源、大小和排除状态的项目
codeclaw config ... 配置仓库、来源、排除和编辑
`codeclaw config --encryption on off
codeclaw export --no-push 在当地出口以供审查
codeclaw export --dry-run 预览在不写入文件的情况下导出/发布的内容
codeclaw confirm ... 运行检查并解锁推拉门
codeclaw export --publish-attestation "..." 审批后推送数据集
codeclaw share [--publish] 快速导出流程，可选发布+数据集卡更新
`codeclaw watch --start --stop
codeclaw watch --logs [--follow] 使用可选流式传输查看守护进程日志
codeclaw watch --monitor [--follow] 实时监控（状态+最近活动）
codeclaw watch --switch-project "<name>" 快速将观察者定位到一个项目
codeclaw watch --set-projects "a,b" 直接设置关联项目范围
codeclaw console 交互式斜线命令终端(/status, /logs, /scope, /run)
codeclaw tui 全屏TUI，带有活动提要、斜线命令、作业和插件
codeclaw serve 通过stdio启动MCP服务器
codeclaw install-mcp 在Claude配置中注册MCP服务器
codeclaw finetune --experimental 预览用于局部实验的微调支架
codeclaw synthesize --project <name> 生成 CODECLAW.md 来自同步会话
codeclaw update-skill claude 安装/更新本地CodeClaw技能

其他源过滤器可用于适配器支持的摄取：

  • cursor, windsurf, aider, continue, antigravity, vscode, zed, xcode-beta

观看透明度示例：

codeclaw watch --status
codeclaw watch --monitor --follow
codeclaw watch --logs --follow
codeclaw watch --pause
codeclaw watch --resume
codeclaw watch --switch-project "codex:codeclaw"

交互式控制台模式：

codeclaw console --source codex
# Then inside the prompt:
/status
/projects
/scope codex:codeclaw
/logs 80
/run export --no-push

全屏TUI模式：

codeclaw
# equivalent explicit command:
codeclaw tui --source both

如果简单 codeclaw 打印导出/确认JSON而不是打开TUI，您使用的是旧版本。 升级并验证：

pip install --upgrade codeclaw
codeclaw --version

TUI内部：

/help
/status
/source codex
/watch on
/logs 80
/projects
/scope codex:codeclaw
/export --dry-run
/jobs
/plugins list

最小本地插件示例(./plugins/echo):

plugins/
  echo/
    plugin.json
    plugin.py

plugin.json:

{
  "name": "echo",
  "version": "0.1.0",
  "entrypoint": "plugin.py",
  "description": "Simple echo command"
}

plugin.py:

from codeclaw.tui.types import CommandResult


def register(ctx):
    def _echo(_app, args):
        return CommandResult(ok=True, message=" ".join(args) if args else "echo")

    ctx.register_command("echo", _echo, "Echo input text", usage="/echo <text>")

MCP内存服务器

安装可选的MCP依赖项：

pip install "codeclaw[mcp]"
codeclaw install-mcp

可用的MCP工具：

  • search_past_solutions(query, max_results=5)
  • get_project_patterns(project=None)
  • get_trajectory_stats()
  • get_session(session_id)
  • find_similar_sessions(context, max_results=5)
  • refresh_index()

隐私和安全

CodeClaw是为默认情况下的私有工作流设计的：

  • 路径和用户名匿名化
  • 秘密和高熵令牌检测
  • 自定义编辑列表
  • 发布前手动确认和认证门
  • 通过密钥环支持的密钥管理为本地工件提供静态加密支持

自动编辑并不完美。在发布之前，一定要审查当地的出口情况。

包装分发

  • 初级：PyPI(pip install codeclaw)
  • 发布工件：wheel/sdist附加到每个GitHub标签发布中。
  • 可选：通过设置存储库机密发布到与PyPI兼容的辅助索引：
    • SECONDARY_PYPI_REPOSITORY_URL
    • SECONDARY_PYPI_USERNAME
    • SECONDARY_PYPI_PASSWORD

README同步策略

README命令文档在CI中强制执行：

  • tests/test_docs_consistency.py 验证命令命名和品牌标记。
  • CLI帮助奇偶校验测试可确保README命令行与真实的CLI界面保持一致。

如果命令更改，CI将失败，直到README更新。

社区

许可证

麻省理工学院-见 许可证.

相关 MCP