README
¶
diffx
Review local Git changes in your browser without modifying your working tree or index.
Install
With Homebrew:
brew install flexdinesh/tap/diffx
Or with Go 1.27.3 or later:
go install github.com/flexdinesh/diffx/cmd/diffx@latest
See Getting started for pinned and
edge versions.
Quick start
From your Git repository, run:
diffx
Your browser opens the captured changes. Review a fixed patch instead with
git diff | diffx. Use diffx --help for usage.
Documentation
User documentation lives in docs-website/:
- Getting started
- Usage
- Reviewing changes
- Piped diffs
- Agent hooks and remote ingestion
- Agent plugins
- MCP
- WebMCP
- API and data
For development and architecture, see docs/development.md and docs/architecture.md. Publishing instructions: docs/release.md.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
diffx
command
|
|
|
diffx-fetcher
command
|
|
|
diffx-server
command
|
|
|
internal
|
|
|
collector
Package collector produces Git-aware ingestion requests.
|
Package collector produces Git-aware ingestion requests. |
|
config
Package config owns persisted settings, separate from private runtime credentials.
|
Package config owns persisted settings, separate from private runtime credentials. |
|
contextservice
Package contextservice manages durable review targets independently of transports.
|
Package contextservice manages durable review targets independently of transports. |
|
controlapi
Package controlapi implements the private, authenticated CLI-to-local-server API.
|
Package controlapi implements the private, authenticated CLI-to-local-server API. |
|
fetcher
Package fetcher mirrors leased GitHub pull requests and collects them offline with the shared collector.
|
Package fetcher mirrors leased GitHub pull requests and collects them offline with the shared collector. |
|
fetchprotocol
Package fetchprotocol is the internal contract between diffx-server and diffx-fetcher.
|
Package fetchprotocol is the internal contract between diffx-server and diffx-fetcher. |
|
github
Package github adapts GitHub App REST, OAuth and webhook wire formats.
|
Package github adapts GitHub App REST, OAuth and webhook wire formats. |
|
githubsync
Package githubsync owns the GitHub integration's application rules: which accounts may follow which repositories, webhook deduplication, coalesced refresh intent and reconciliation.
|
Package githubsync owns the GitHub integration's application rules: which accounts may follow which repositories, webhook deduplication, coalesced refresh intent and reconciliation. |
|
hooks
Package hooks schedules finite, detached checkout synchronization workers.
|
Package hooks schedules finite, detached checkout synchronization workers. |
|
identityservice
Package identityservice owns remote account and credential policies.
|
Package identityservice owns remote account and credential policies. |
|
ingestion
Package ingestion defines snapshot contracts, pure identity rules and HTTP clients.
|
Package ingestion defines snapshot contracts, pure identity rules and HTTP clients. |
|
ingestionqueue
Package ingestionqueue owns durable admission and worker contracts.
|
Package ingestionqueue owns durable admission and worker contracts. |
|
processlock
Package processlock provides kernel-owned process locks.
|
Package processlock provides kernel-owned process locks. |
|
remoteserver
Package remoteserver composes distributed identity and owner-scoped applications.
|
Package remoteserver composes distributed identity and owner-scoped applications. |
|
reviewdata
Package reviewdata defines storage-independent review identities and results.
|
Package reviewdata defines storage-independent review identities and results. |
|
serverapp
Package serverapp composes stored-data application services and transports.
|
Package serverapp composes stored-data application services and transports. |
|
submission
Package submission preserves immutable manual uploads across CLI invocations.
|
Package submission preserves immutable manual uploads across CLI invocations. |
|
version
Package version reports diffx build metadata.
|
Package version reports diffx build metadata. |
|
packages
|
|
|
tools
|
|
|
check-boundaries
command
Command check-boundaries validates production dependencies for the active Go build target.
|
Command check-boundaries validates production dependencies for the active Go build target. |
|
release-version
command
|
|
|
stage-web
command
|
Click to show internal directories.
Click to hide internal directories.