difit

v2.2.4

A lightweight command-line tool that spins up a local web server to display Git commit diffs in a GitHub-like Files changed view For more information about how to use this package see README

Latest version published 10 days ago

License: MIT

NPM

GitHub

Package Health Score

73 / 100

security
No known security issues
popularity
Limited
maintenance
Healthy
community
Sustainable

Explore Similar Packages

Security

No known security issues

All security vulnerabilities belong to production dependencies of direct and indirect packages.

Security and license risk for significant versions

All Versions

Version				Vulnerabilities	License Risk
2.2.4	\|	11/2025	Popular	0 C 0 H 0 M 0 L	0 H 0 M 0 L
2.1.2	\|	07/2025		0 C 0 H 0 M 0 L	0 H 0 M 0 L
0.0.6	\|	07/2025		0 C 0 H 0 M 0 L	0 H 0 M 0 L
1.1.12	\|	07/2025		0 C 0 H 0 M 0 L	0 H 0 M 0 L

License

MIT

Security Policy

Yes

Is your project affected by vulnerabilities?

Scan your projects for vulnerabilities. Fix quickly with automated fixes. Get started with Snyk for free.

Get started free

Popularity

Limited

Weekly Downloads (463)

GitHub Stars: 1.61K
Forks: 53
Contributors: -

Direct Usage Popularity

The npm package difit receives a total of 463 downloads a week. As such, we scored difit popularity level to be Limited.

Based on project statistics from the GitHub repository for the npm package difit, we found that it has been starred 1,614 times.

Downloads are calculated as moving averages for a period of the last 12 months, excluding weekends and known missing data points.

Community

Sustainable

Readme.md: Yes
Contributing.md: No
Code of Conduct: No
Contributors: 0
Funding: Yes

This project has seen only 10 or less contributors.

We found a way for you to contribute to the project! Looks like difit is missing a Code of Conduct.

Embed Package Health Score Badge

Maintenance

Healthy

Commit Frequency

Open Issues: 10
Open PR: 3
Last Release: 10 days ago
Last Commit: 4 days ago

Further analysis of the maintenance status of difit based on released npm versions cadence, the repository activity, and other data points determined that its maintenance is Healthy.

We found that difit demonstrates a positive version release cadence with at least one new version released in the past 3 months.

As a healthy sign for on-going project maintenance, we found that the GitHub repository had at least 1 pull request or issue interacted with by the community.

Keep your project healthy

Check your package.json

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Node.js Compatibility: >=21.0.0

Age: 5 months
Dependencies: 13 Direct
Versions: 48
Install Size: 769 kB
Dist-tags: 1
# of Files: 68
Maintainers: 1
TS Typings: No

difit has more than a single and default latest tag published for the npm package. This means, there may be other tags available for this package, such as next to indicate future releases, or stable to indicate stable releases.

Readme

English | 日本語 | 简体中文 | 한국어

difit screenshot

difit 是一个让你使用 GitHub 风格查看器查看和审查本地 git 差异的 CLI 工具。除了清晰的视觉效果外，评论还可以作为 AI 提示进行复制。AI 时代的本地代码审查工具！

⚡ 快速开始

npx difit    # 在 WebUI 中查看最新提交的差异

🚀 使用方法

基本用法

npx difit                     # 查看单个提交差异
npx difit  [compare-with]     # 比较两个提交/分支
npx difit --pr         # 审查 GitHub 拉取请求

单个提交审查

npx difit          # HEAD（最新）提交
npx difit 6f4a9b7  # 特定提交
npx difit feature  # feature 分支上的最新提交

比较两个提交

npx difit @ main         # 与 main 分支比较（@ 是 HEAD 的别名）
npx difit feature main   # 比较分支
npx difit . origin/main  # 比较工作目录与远程 main

特殊参数

difit 支持常见差异场景的特殊关键字：

npx difit .        # 所有未提交的更改（暂存区 + 未暂存）
npx difit staged   # 暂存区更改
npx difit working  # 仅未暂存的更改

GitHub PR

npx difit --pr https://github.com/owner/repo/pull/123

difit 使用以下方式自动处理 GitHub 认证：

GitHub CLI（推荐）：如果您已使用 gh auth login 登录，difit 将使用您现有的凭据
环境变量：设置 GITHUB_TOKEN 环境变量
无认证：公共仓库无需认证即可工作（有速率限制）

GitHub Enterprise Server

对于 Enterprise Server PR，您必须设置在您的 Enterprise Server 实例上生成的令牌：

转到 https://YOUR-ENTERPRISE-SERVER/settings/tokens
生成具有适当范围的个人访问令牌
将其设置为 GITHUB_TOKEN 环境变量

标准输入

通过使用管道通过标准输入传递统一差异，您可以使用 difit 查看来自任何工具的差异。

# 查看来自其他工具的差异
diff -u file1.txt file2.txt | npx difit

# 审查保存的补丁
cat changes.patch | npx difit

# 与合并基础比较
git diff --merge-base main feature | npx difit

# 将整个现有文件视为新添加进行审查
git diff -- /dev/null path/to/file | npx difit

⚙️ CLI 选项

标志	默认值	描述
``	HEAD	提交哈希、标签、HEAD~n、分支或特殊参数
`[compare-with]`	-	要比较的可选第二个提交（显示两者之间的差异）
`--pr`	-	要审查的 GitHub PR URL（例如：https://github.com/owner/repo/pull/123）
`--port`	4966	首选端口；如果被占用则回退到 +1
`--host`	127.0.0.1	绑定服务器的主机地址（使用 0.0.0.0 进行外部访问）
`--no-open`	false	不自动打开浏览器
`--mode`	side-by-side	显示模式：`inline` 或 `side-by-side`
`--tui`	false	使用终端 UI 模式而不是 WebUI
`--clean`	false	启动时清除所有现有评论和已查看的文件

💬 评论系统

difit 包含一个审查评论系统，便于向 AI 编码代理提供反馈：

添加评论：单击任何差异行上的评论按钮或拖动选择范围
编辑评论：使用编辑按钮编辑现有评论
生成提示：评论包含"复制提示"按钮，可为 AI 编码代理格式化上下文
复制全部：使用"复制所有提示"以结构化格式复制所有评论
持久存储：评论按每个提交保存在浏览器 localStorage 中

评论提示格式

src/components/Button.tsx:L42   # 此行自动添加
使此变量名更具描述性

对于范围选择：

src/components/Button.tsx:L42-L48   # 此行自动添加
此部分是不必要的

🎨 语法高亮语言

JavaScript/TypeScript：.js, .jsx, .ts, .tsx
Web 技术：HTML, CSS, JSON, XML, Markdown
Shell 脚本：.sh, .bash, .zsh, .fish
后端语言：PHP, SQL, Ruby, Java, Scala
系统语言：C, C++, C#, Rust, Go
移动语言：Swift, Kotlin, Dart
其他：Python, Protobuf, YAML, Solidity, Vim Script

🛠️ 开发

# 安装依赖
pnpm install

# 启动开发服务器（带热重载）
# 这会同时运行 Vite 开发服务器和 CLI，NODE_ENV=development
pnpm run dev

# 构建并启动生产服务器
pnpm run start 

# 构建生产版本
pnpm run build

# 运行测试
pnpm test

# 代码检查和格式化
pnpm run lint
pnpm run format
pnpm run typecheck

开发工作流程

pnpm run dev：同时启动 Vite 开发服务器（带热重载）和 CLI 服务器
pnpm run start ：构建所有内容并启动生产服务器（用于测试最终构建）
开发模式：使用 Vite 的开发服务器进行热重载和快速开发
生产模式：提供构建的静态文件（供 npx 和生产构建使用）

🏗️ 架构

CLI：使用 Commander.js 进行参数解析，具有全面的验证
后端：Express 服务器配合 simple-git 进行差异处理
GitHub 集成：Octokit 用于 GitHub API，具有自动认证（GitHub CLI + 环境变量）
前端：React 18 + TypeScript + Vite
样式：Tailwind CSS v4，带有类似 GitHub 的深色主题
语法高亮：Prism.js 带动态语言加载
测试：Vitest 用于单元测试，测试文件与源代码放在一起
质量：ESLint、Prettier、lefthook 预提交钩子

📋 要求

Node.js ≥ 21.0.0
包含要审查的提交的 Git 仓库

📄 许可证

MIT

difit dependencies

@octokit/rest @parcel/watcher commander express ink lucide-react open prism-react-renderer prismjs react react-dom react-hotkeys-hook simple-git

FAQs

What is difit?

A lightweight command-line tool that spins up a local web server to display Git commit diffs in a GitHub-like Files cha... Visit Snyk Advisor to see a full health score report for difit, including popularity, security, maintenance & community analysis.

Is difit popular?

The npm package difit receives a total of 463 weekly downloads. As such, difit popularity was classified as limited. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is difit well maintained?

We found that difit demonstrated a healthy version release cadence and project activity. It has a community of 0 open source contributors collaborating on the project. See the full package health analysis to learn more about the package maintenance status.

Is difit safe to use?

The npm package difit was scanned for known vulnerabilities and missing license, and no issues were found. Thus the package was deemed as safe to use. See the full health analysis review.

Last updated on 7 December-2025, at 08:50 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP