Changelog
This file is made for human readers. It contain important (not all) changes made for a release, as well as the release date. Each version contains a link to all closed issues into the current version and a link to the binary corresponding to the version.
At any time, you can find the latest GitRoot binary for linux amd64 at https://gitroot.dev/releases/gitroot-last.
unreleased
- zig sdk continue fakeServer implem
- update deps:
- go
1.25to1.27.3- gjson
v1.18.0tov1.20.0 - go-git
v6.0.0-alpha.2tov6.0.0-beta.1 - wazero
v1.11.0tov1.12.0
- gjson
- rust
1.90.0to1.99.1 - node
24.8to26.13 - tinygo
0.40.1to0.44.0 - zig
0.16.0to0.17.0- zeit
0.9.0to0.10.0
- zeit
- go
0.5.0 (17/10/2026) is last
Commit: 13a71463735e7aff0f2fc0cf7351cc63fd16799a
gitroot-0.5.0-linux-amd64 sha256 3b7e3d1daf1053924bc1f10dc21398ca066f66bba0ba359cccb53ace803c0f40
gitroot-0.5.0-linux-arm64 sha256 ba68ebe9156f783ff46c381d600d1d3339cefb15814eb5ea332d895dccdeae08
gitroot-0.5.0-darwin-amd64 sha256 99085fb60aa349d4fc023134697adaef6219de160315eec577e161bce06abde9
gitroot-0.5.0-darwin-arm64 sha256 ada7dbc8f93539242106cc1eb2fa1831a427066ee802a99f0d30f8ab955e6599
- add a flag to enable sftp #f74b
- simplify release with a script #dba0
- fix bug: updating plugin conf run a worktree but then commit was not dispatched to other plugins
- fix bug: when a plugin was added multiple times in plugins.yml, only first was loaded
- fix bug: repositories already created had bad extensions and objectformat in
.git/config - fix bug: don’t try to use plugin without purl
- after sendReport, plugins can render in web/cache for commits generated during sendReport
- group report #601a by using newly pull-iterator
- better plugins fs management, a plugin mounted without fs couldn’t access files until close
- fill users.yml with first commit name/email when a new user push a new branch, like that stigma plugin can find the user #91a1
- add sftp handle to read/write in project web directory. Only user with right to write in defaultBranch can write in webContent
- callFunc can have a
configurationfor the plugin to call - when a plugin is called by another, gitroot call
initof the plugin (withInitKind=funccall) before calling the func - add httClient to make httpRequest from plugin
- introduce
schedulea way to launch plugins on regular time - BREAKING
initplugin function change signature fromfunc Init(repoName string, confHasChanged bool, serializedConf string)tofunc Init(repoName string, initKind model.InitKind, serializedConf string)where InitKind can beconfHasChange,diff,scheduleorfunccall - new plugin-sdk for zig in libs/zig
- users management:
- rework group to be able to make a
contributorsgroup where users can share branches, but not commit tomain - add
NbMaxBranchesPerProjectBeforeRejectingAnonymousin forgeConfig.yml andNbMaxBranchesBeforeRejectingAnonymousin repoConfiguration.yml to avoid spam from anonymous users. By default it’s 10, meaning that when your repo has 10 branches (who have added them doesn’t matter), anonymous user can’t push new branch. But know users (present in users.yml) can. Both values, in forgeConf and in repo must pass. If forgeConf is 2, even if repo is 100, max nb branch will be 2 (inverse is true too). To made it limitless put-1. And0means no anonymous is allowd to create branch.
- rework group to be able to make a
- BREAKING plugin-sdk are generated from sdkgenerator #8fba
- go:
CmdStats.TotalCPUTimeMsbecomeCmdStats.TotalCpuTimeMs - go: delete deprecated methods
ModifyContent(filepath, content string)useWorktree().WriteContent(filepath, content string)ModifyWebContent(filepath, content string)useWebcontent().WriteContent(filepath, content string)ReplaceWebContent(filepath, oldContent, content string)useWebcontent().ReplaceContent(filepath, oldContent, content string)ModifyCacheContent(filepath, content string)useCache().WriteContent(filepath, content string)
- ts: all models are generated from go
- ts: delete all
static build()useconstructorinstead - rust: all models are generated from go, only imports impacted
- go:
- repair
app/testsuite/demo.shwith new purl plugin - BREAKING use PURL to define plugin #4e8f and #5dd3
- in
.gitroot/plugins.ymlreplace url, checksum, name and version with:- purl: pkg:gitroot/gitroot/ladybug@0.4.0?registry=gitroot.dev%2Freleases%2F0.4.0&checksum=sha256:7409837469ce89d5c9fd8dd48236764650f48523ff4d81295967154977a01635 - in plugin-sdk callFunc to other plugin replace pluginName (e.g.
ladybug) bypkg:gitroot/gitroot/ladybug(optional version) - will generate new plugin data directory from
gitrootData/data/plugins/ladybugtogitrootData/data/plugins/gitroot-ladybug - will generate new plugin cache directory from
gitrootData/data/cache/repo1/ladybugtogitrootData/data/cache/repo1/gitroot-ladybug - will generate new user from
ladybug@localhosttogitroot-ladybug@localhost
- in
- rebase go-git graft and graft2
- clean force-push scenario (no more found acestor) #4f8d
- delete lof of todo about branches/checkout/HEAD
- start use of sideband
- configured the Hop plugin to run tests on gitroot.dev #3a5e - graft
- repaired existing tests (many were failing as they hadn’t been run regularly)
- the flaky testsuite should now be more stable
0.4.0 (22/04/2026)
Commit: 0d57f5943dde9102f43ea08a2c047f824b5559d5
gitroot-0.4.0-linux-amd64 sha256 4f0fb91ce26c61361f820d268974cf95a1d7baa1bcfc5f78b3a7b4f37d8b4fed
gitroot-0.4.0-linux-arm64 sha256 9ee4abc4888d2578fa107958b10272e97210a3a7dc7e13addddee221e4e900d2
gitroot-0.4.0-darwin-amd64 sha256 a09a675aec206afcf6984740e695172a55080ca37b668d26b9454f6b358e6e5d
gitroot-0.4.0-darwin-arm64 sha256 86bc8393e55cff929ca20628841f379fc031378cf8399a9fde5a2e1a56cd2c4b
GitRoot
- run plugins in order of project not root
- if a plugin has no file impacted, it will not run anymore
- sync plugin inactive plugin in sub repositories
- integrate
pollenandhopplugin in tests - BREAKING plugin sdk changes:
- create model.File
- from
AddFile(path string)toAddFile(file model.File) - from
ModFile(fromPath string, toPath string)toModFile(file model.File) - from
DelFile(path string)toDelFile(file model.File)
- new plugin api:
ExportFunc(name string, callback func(args map[string]string) (map[string]string, error))permit to export a function, when another plugin will call it, the callback will be called with args. Only string are permitted. Can return multiple values but only strings like args.CanCallFunc(plugin string, name string, args map[string]string) boolcheck if a plugin can call a function. If plugin is not installed/activated, has not the func or user has disable the call to it, you will get a false.CallFunc(plugin string, name string, args map[string]string) (map[string]string, error)permit to call the function of another plugin. If the plugin don’t exist or the plugin has not exported this function the rror will beplugin or method not found.CopyFile(fromFs model.FsBase, fromPath string, toFs model.FsBase, toPath string) errorcopy a file from an fs to anotherDeleteFile(fromFs model.FsBase, filename string) errordelete a fileMoveFile(fromFs model.FsBase, fromPath string, toFs model.FsBase, toPath string) errormove a file fron a fs to anotherReplaceContent(fromFs model.FsBase, filepath string, oldContent string, content string) errorreplace content of a fileWriteContent(fromFs model.FsBase, filepath string, content string) errorwrite to a file
- deprecated plugin api:
ModifyContent(filepath, content string)useWorktree().WriteContent(filepath, content string)ModifyWebContent(filepath, content string)useWebcontent().WriteContent(filepath, content string)ReplaceWebContent(filepath, oldContent, content string)useWebcontent().ReplaceContent(filepath, oldContent, content string)ModifyCacheContent(filepath, content string)useCache().WriteContent(filepath, content string)
- new executors features:
- BREAKING Removed the requirement to sign commits and push using the same SSH key.
- GitRoot no longer generates
.gitroot/init.shand.gitroot/allowed_signersfiles. - Users can now push unsigned commits or commits from other authors (enabling rebases with plugin commits).
- The
stigmaplugin can be used to restore this functionality with the following behavior:- Generates
.gitroot/init.shand.gitroot/allowed_signersfiles. - Maintains the
.gitroot/allowed_signersfile with all valid keys. - Reports unsigned commits as warnings.
- Reports invalidly signed commits as errors.
- Generates
- GitRoot no longer generates
- start to clean tests by adding libs and cmd in testsuite.
- add plugins section
Plugins
- stigma: assists in configuring, verifying, and reporting on commit signatures.
- move changelog to own directory
- hop
- 0.0.2 compatible with gitroot plugin-sdk 0.4.0
- rework report layout
- BREAKING add
pipelinesToWebDirin conf to make artifacts and logs accessible in web, set empty to desable,/pipelinesby default - move changelog to own directory
- pollen
- 0.0.3 compatible with gitroot plugin-sdk 0.4.0
- move changelog to own directory
- ladybug:
- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
- move changelog to own directory
- silo:
- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
- clean cache when conf has changed #4f54
- move changelog to own directory
- grafter:
- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
- move changelog to own directory
- apex:
- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
- render files in other branches than main #de9a
- emit report when render a file from other branch
- fix bug: rendering of local link #bf18
- fix bug: impossible to put some metadata in apex #71d7
- BREAKING don’t render markdown by default. Install
apex_markdownplugin to do it. Andapex_codeto hilight code in markdown. - BREAKING install
apex_codeplugin to render worktree with hilight on dource files. - depends on
apex_markdownandapex_codewhich are optional dependencies - add layouts to extend representation of data #bbf1
- move changelog to own directory
- apex_markdown: export func
renderMdwith argsfpthe filepath of the mardown andmdthe content. Returnhtmlthe result andmetasthe metadata.- depends on
apex_codeto render code - depends on
apex_mermaidto render mermaid charts - add rust, typescript and json icon
- move changelog to own directory
- depends on
- apex_code: export func
renderCodewith argscodethe code to render andlangthe language of the code. Returnhtmlthe result.- move changelog to own directory
- apex_mermaid: export func
renderCodewith argscodethe code mermaid to render. Returnhtml(svg) the result.- move changelog to own directory
0.3.0 (20/12/2025)
Commit: 11ec919c30bb10bb73560e624f772675d1f34c91
gitroot-0.3.0-linux-amd64 sha256 9697a5a5b3ae2ecab339450908705bf53e393154d3d2c3ebed8b5f89cd0cee5e
gitroot-0.3.0-linux-arm64 sha256 e268cb95136f6f871d2090c1240c8d3952a58312fd4211b40646b553264ac32b
gitroot-0.3.0-darwin-amd64 sha256 91eb4f5568acff907f99a51c38e14a443b65cae369c0451d033cc6b1a4bfa667
gitroot-0.3.0-darwin-arm64 sha256 4b64f6807d01230ae6d2e4b89fa42c245ea9bf924a81d5eb5f929c6b12bfd5f7
GitRoot
- Add 🗨 Contact page
- Use mise tasks thanks to Zon Orti the #3 contributor 🚀
- add in the plugin sdk the
report()api, to be able to report something to user. Don’t use it to report bad behavior,log()andlogError()are here for that. - add
reporterinterface to plugin sdk, to prevent GitRoot that a plugin can report something to user. See grafter as the first use case. - BREAKING add
execconfin forgeConf, permit to enable one kind of executor and to set it’s conf - BREAKING add
externalsshaddrandexternalhttpaddrproperty in forgeConf, permit to displaygit clone ssh://gitroot.dev/in web for example #a716 - implement the first
updaterwich handle the previous breaking - add rust lib to build plugin
- add
Exec([]commands)method for plugin, need exec permission - allow to name
mallocandfreefunction in wasn guestgitrootAllocandgitrootFree - garbage memory of plugin between 2 calls
- use mise to simplify dev environment and update go, tinygo and node to latest version
Plugins
- hop: execute process on host hop-0.0.1.wasm sha256: b67e9418702648a493f40d4f5375b51a6ade2812382ddc43c4a1133d8c5c3b44
- use the new report api
- pollen: pollen-0.0.2.wasm sha256: e6e94e93514d3fe1e65506f5ac72a01b84b792bc6c07009eadc194942fc63ca1
- 0.0.2 compatible with gitroot plugin-sdk 0.3.0
- ladybug: ladybug-0.0.3.wasm sha256: adfaf88dc15ca5d53019ff194a32abec9c914c6cdf676ef4de589c1a4cfd12d4
- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
- silo: silo-0.0.3.wasm sha256: f38f8b71b68eddd1ce895a645e8c27052aab1f7607fc8182beb66b4e3e0fd2df
- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
- grafter: grafter-0.0.3.wasm sha256: 9d63e0a232ea8dcdbd28ffc5793b56eada5981fc85296dfb8fd7342b3379d4e2
- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
- implement reporter api to display hop reports
- apex: apex-0.0.3.wasm sha256: 3f7e22f834ce7e16231f6fa08495517c1ec021cb801b9b2885345a8deb16ebf0
- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
- add favicon configuration #8c3f
- add html metadata configuration
- fix bug: 404 page not found is styled #4c5b
- fix bug: current menu is now hilighted and marked with
aria-current="page"#6eeb - BREAKING don’t render metadata by default, file should have
apexRenderMetadatas: truein metadata to allow it, not final solution but good enough for now
0.2.0 (18/09/2025)
Commit: 089d7caca0dfd7ac079aa92021b5f896e9f0fdb1
gitroot-0.2.0-linux-amd64 sha256 91c37b86a36253dc9a25f89c772035ab8445fc7c2f8f330128cb12425cb9b2f6
gitroot-0.2.0-linux-arm64 sha256 d866ac45007f94d4d9967915efcff6181a32fe0791e50845620c6152f8dc1651
gitroot-0.2.0-darwin-amd64 sha256 a8784f3b82c7814e36066c5dda7e540920378159654658dc7777c4fe73d1b59d
gitroot-0.2.0-darwin-arm64 sha256 70f23407a13b8dd20852382906c05dc2aa268f74cbef31358cec861cba89f04c
GitRoot
- add assemblyscript lib to build plugin
- add
ReplaceWebContentBuilder(filename, old, new)method for plugin, need mod permission - after a merge delete branch and clean users.yml
- cross compilation #70d0
- add
Commits(from string, to string) ([]Commit, error)method for plugin to access commits between 2 hash - check that the plugin is compatible with current version
- update plugins: change URL in
plugins.ymlof root repository - download plugins from http(s) and checksum them
- compile plugins AOT and keep compilation
- garbage collect plugins after execution #f1ab
- fix empty FS after execution #95b0
Plugins
- pollen: rss generator pollen-0.0.1.wasm sha256: 49cd8e1846b1612a0d5686918b502fe29e070e7bf9613c1ba9a1dfe5417d0f2a
- ladybug: ladybug-0.0.2.wasm sha256: 0c755bb2dc5cc037216b29ba1709875afee425ee429b6be97f0d5e137067acff
- 0.0.2 compatible with gitroot
- fix bug: do not delete
---in body of files
- silo: silo-0.0.2.wasm sha256: 66fe44b4e0984154bda0867a9b35ea39b0be3d92a89e4e542b70472fadf2f78e
- grafter: grafter-0.0.2.wasm sha256: 9ce5e36af1fd53a6547ec51d55356a661a05ae617b16ef97b1eae0dd0cce22c0
- 0.0.2 compatible with gitroot
- better diff
- BREAKING change state of graft in metadata
- apex: apex-0.0.2.wasm sha256: 4c7d1b84f768a6aea11393ea2bc116a7be30fd12380fd7e11f283d5970028119
- 0.0.2 compatible with gitroot
- add line heading
- generate branches page and one page by branch with commits
0.1.0 (20/05/2025)
Initial GitRoot version 🎉
Commit: fa6d1600606efdc590eb2f0411305e971fdd854d
gitroot-0.1.0-linux-amd64 sha256 e70d24e2631708ae4b778f9f60de03fad5087dd1fb2845955a9ed5c758a5ca0a
gitroot-0.1.0-darwin-amd64 sha256 622abd155657f2b3674b9fab71de2438774005054deb30301787d3a1ff37ff1a
gitroot-0.1.0-darwin-arm64 sha256 7946ad03f109c7d9cdb93fc6ec1b0838b10dde3c7bf67d4254374f5f9b9b19a5
GitRoot
- launch GitRoot by specifying where to store data (all data will be written in this path)
- accept git commands through ssh (clone, pull and pull)
- manage users (who can write in which repositories)
- install and activate plugins
- repositories can be viewed online
Plugins
- ladybug: add properties to md files ladybug-0.0.1.wasm sha256: af00a9f14a27399f383d0cc23415e14e7d6180c167d1504018f11166346ebb55
- silo: regroup, filter, sort files in a new md file in git silo-0.0.1.wasm sha256: 99bc06d9d6f020c5df216fd6134306079aec26eacee9ad9bbabbc259097e618a
- grafter: manage, review and merge of branches in git grafter-0.0.1.wasm sha256: 6645615df36a9938adac300d8d46fe298f8f53fb2e69713a495b83b0f114f40a
- apex: transform md file to html one and write them in web, optionally generate worktree apex-0.0.1.wasm sha256: 9570f005ad70be04eab3c900acd11d5c2ccf48fef5d4c17536c9cf79c8fd333e