ai-worklog
v1.0.6
Published
AI 对话工作日志自动收集工具 —— 从 Claude Code / Codex 对话记录生成每日工作日志并推送到 GitLab
Maintainers
Readme
工作日志自动收集系统
自动从 Claude Code 和 Codex 的 AI 对话记录中提取工作内容,调用 Claude API 生成结构化工作日志并提交到 GitLab。
快速开始
# 将 scripts/ 加入 PATH(建议加到 ~/.zshrc 或 ~/.bashrc)
export PATH="$HOME/Developer/local-work-record/scripts:$PATH"
# 生成今天的日志(自动 commit + push)
worklog
# 生成昨天的日志
worklog yesterday
# 指定日期
worklog 2026-03-06
# 生成但不 push
worklog --no-push
# 仅预览收集到的数据(不生成文件)
worklog --dry-run数据来源
| 来源 | 路径 | 过滤规则 |
|------|------|----------|
| Claude Code | ~/.claude/projects/{project}/*.jsonl | 按 timestamp 过滤日期,过滤系统注入消息 |
| Codex | ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl | 按目录日期,提取 event_msg/user_message |
过滤的系统消息前缀:
# AGENTS.md instructions<environment_context><system-reminder><local-command-caveat>- 含超过 20 个
<标签的消息
日志格式
# 工作日志 - 2026-03-07
## 今日概览
- 涉及项目数: N
- AI 对话次数: N(Claude Code: N,Codex: N)
## 项目工作详情
### [project-name] 一句话概括
**工作类型:** 探索 + 开发
**主要工作:**
- ...
**关键决策:**
- ...
## 今日总结
...
---
*由 collect_work_log.py 自动生成于 ...*注意:日志不估算工时,工时由工程师自报填写。
目录结构
local-work-record/
├── scripts/
│ ├── collect_work_log.py # 主脚本(Python 3.8+,无额外依赖)
│ └── worklog # Shell 入口(chmod +x)
├── logs/
│ └── 2026/
│ └── 2026-03-07.md
└── README.mdAPI 配置
脚本自动从 ~/.claude/settings.json 读取:
env.ANTHROPIC_AUTH_TOKEN— API 密钥env.ANTHROPIC_BASE_URL— API 地址(默认https://api.anthropic.com)
无需手动配置任何环境变量。
命令行选项
worklog [date] [options]
date:
today 今天(默认)
yesterday 昨天
YYYY-MM-DD 指定日期
options:
--no-push 仅 commit,不 push 到远程
--dry-run 仅预览收集数据,不生成文件
--no-git 仅生成文件,跳过所有 git 操作