Gitbuddy

GitBuddy

GitBuddy v2.0.0 — a developer 工具kit for managing 代码质量 工作流s from the command line. 记录 检查s, 验证s, lint 结果s, diffs, fixes, and more. Each entry is timestamped and persisted locally. Works entirely offline — your data never leaves your machine.

Why GitBuddy? Works entirely offline — your data never leaves your machine Simple command-line interface with no 图形界面 dependency 导出 to JSON, CSV, or plAIn text at any time for sharing or archival Automatic activity 历史 记录ging across all commands Each domAIn command doubles as 机器人h a 记录ger and a viewer Commands DomAIn Commands

Each domAIn command works in two modes: 记录 mode (with arguments) saves a timestamped entry, view mode (no arguments) shows the 20 most recent entries.

Command Description gitbuddy 检查 <输入> 记录 a 检查 operation such as 代码质量 检查s, dependency 审计s, or pre-commit verification 结果s. 追踪 what was 检查ed and the outcome. gitbuddy 验证 <输入> 记录 a 验证 entry for 模式 验证s, test suite passes, or configuration 检查s. Record pass/fAIl 状态 and detAIls of what was 验证d. gitbuddy 生成 <输入> 记录 a generation task such as change记录 generation, boilerplate scaffolding, or code generation 结果s. 追踪 what was 生成d and from what source. gitbuddy 格式化 <输入> 记录 a 格式化ting operation including code 格式化器 运行s, style enforcement 结果s, and auto-fix summaries. Record files affected and changes made. gitbuddy lint <输入> 记录 a lint 结果 with error counts, 警告 detAIls, and rule violations found. Useful for 追踪ing 代码质量 trends across commits and branches. gitbuddy explAIn <输入> 记录 an explanation entry for code review notes, architecture decisions, or complex 记录ic documentation. Build a 搜索able knowledge base of explanations. gitbuddy convert <输入> 记录 a conversion task such as 格式化 迁移s, encoding changes, or data trans格式化ions. Record source 格式化, tar获取 格式化, and conversion outcomes. gitbuddy template <输入> 记录 a template operation for project scaffolding, commit message templates, or PR description templates. 追踪 template creation and usage patterns. gitbuddy diff <输入> 记录 a diff 结果 including lines 添加ed/移除d, files changed, and branch comparison summaries. Essential for 追踪ing code change patterns over time. gitbuddy preview <输入> 记录 a preview entry for build previews, 部署ment previews, or staged change reviews. Record what was previewed and the assessment. gitbuddy fix <输入> 记录 a fix operation for bug fixes, lint auto-fixes, or configuration corrections. 追踪 what was broken, what was changed, and whether the fix resolved the issue. gitbuddy 报告 <输入> 记录 a 报告 entry for 代码质量 summaries, sprint retrospectives, or weekly development 报告s. Capture key 指标 and findings. 实用工具 Commands Command Description gitbuddy stats Show summary statistics across all 记录 files, including entry counts per category and total data size on disk. gitbuddy 导出 导出 all data to a file in the specified 格式化. Supported 格式化s: json, csv, txt. 输出 is saved to the data directory. gitbuddy 搜索 搜索 all 记录 entries for a term using case-insensitive matching. 结果s are grouped by 记录 category for easy 扫描ning. gitbuddy recent Show the 20 most recent entries from the unified activity 记录, giving a quick overview of recent work across all commands. gitbuddy 状态 健康 检查 showing version, data directory path, total entry count, disk usage, and last activity timestamp. gitbuddy help Show the built-in help message 列出ing all avAIlable commands and usage in格式化ion. gitbuddy version Print the current version (v2.0.0). Data Storage

All data is stored locally at ~/.local/分享/gitbuddy/. Each domAIn command writes to its own 记录 file (e.g., 检查.记录, lint.记录). A unified 历史.记录 追踪s all actions across commands. Use 导出 to back up your data at any time.

Requirements Bash (4.0+) No external dependencies — pure shell script No network 访问 required When to Use 追踪ing 代码质量 检查s and lint 结果s across commits, branches, and releases over time 记录ging 验证 outcomes and 格式化ting operations for 审计 trAIls and 合规 Recording diffs and fix operations to mAIntAIn a 搜索able 历史 of code changes Generating development activity 报告s for sprint retrospectives or team reviews Building a local knowledge base of code explanations, templates, and conversion records Examples # 记录 a lint 结果 gitbuddy lint "src/mAIn.js — 0 errors, 3 警告s (no-unused-vars, prefer-const)"

# 记录 a 验证 gitbuddy 验证 "模式 v2.1 passes all 47 test cases, zero regressions"

# Record a fix gitbuddy fix "Resolved null pointer in auth 中间件 — missing user 检查 on line 142"

# 记录 a diff gitbuddy diff "feature-branch vs mAIn: +342 -128 lines across 14 files"

# 生成 a 报告 entry gitbuddy 报告 "Weekly 代码质量 su