Skip to content
theweiPublic

About

Native macOS Git client with a Files viewer (Go, MyGo Native UI)

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Solco Git

checks release license platform

Solco Git: unstaged and staged files with their diffs

A native macOS Git client with a Files viewer: Fork's way of working on a repository, plus reading its source. One window, a workspace per repository chosen from a pull-down in the title band. Go + MyGo Native UI; it reads and changes repositories through the git CLI only (the runner in solco-gitkit). There is no Herdr, Pane, terminal or agent in it (a "workspace" here is this app's own list of repositories).

It is the standalone form of what Solco's Git and Files views used to be. Solco links here one way, through the URL scheme below; Solco Git keeps its own preferences and imports nothing from Solco.

Download

Grab the latest .dmg (Apple Silicon or Intel) from Releases or the website. Builds are signed ad hoc, not notarized: the first time, open the app with right-click → Open. The app checks for signed updates once a day and from Solco Git → Check for Updates….

What it does

Area In it
Changes Staged / unstaged lists, diff (unified or split), stage and unstage by file, hunk or line, discard, commit and amend, stash, patches, conflicts, rebase / merge / cherry-pick / revert state
Commits Commit graph with branch / tag / stash decoration, ref sidebar (branches, remotes, tags, stashes, worktrees, submodules), commit review with Diff | Tree (the whole tree at that commit, as Fork's File Tree), fetch / pull (ff, merge, rebase) / push, Push Multiple… (several branches and tags in one push, never forced), reflog
Files Ignore-aware tree, native code view; Markdown rendered by MyGo's own Markdown view with a Rendered | Source switch (up to 2 MiB, source beyond) that draws raw HTML, math and Mermaid and has its own find (⌘F); PNG / JPEG / GIF / WebP / BMP shown as native bitmaps, an SVG drawn with an Image | Source switch, AVIF / ICO on a tiny page of the system engine, Quick Look / Copy Path / Reveal in Finder on a row, a preview or the Actions menu, start page, Changed | All with M / U marks and folder dots, change bars in the gutter, Plain | Blame, History, new / rename / delete
Images A changed image shows 2-up, Swipe or Onion compare
Window One window; the title band's workspace pull-down always names the repository in front — open it to search the list (it scrolls past a fixed height), ↵ switches and re-reads; Settings → Workspaces adds, reorders and removes them; every repository opened from anywhere (⌘O, a link, a dropped folder, Recent) joins the list; restored on launch, the same repository never opens twice. Quick Launch (⇧⌘O), recents, drop a folder on the window. A workspace here is this app's own list of repositories, not Herdr's

Not in it, by decision: Clone and credential handling, accounts / pull requests, Git Flow and LFS, custom commands, statistics, AI review and AI commit messages, snapshots, force push and git clean, "Open as Workspace" (that is Solco's).

Run, check, build

GOTOOLCHAIN=auto go tool mygo dev      # run the app
GOTOOLCHAIN=auto go vet ./...
GOTOOLCHAIN=auto go test ./...         # headless; real `git` in temporary repositories
GOTOOLCHAIN=auto go tool mygo build    # build/darwin-arm64/Solco Git.app

The tests render the window headless (ui.Tester) and never touch your repositories. To keep the rendered frames for a design review, set a directory:

SOLCOGIT_EVIDENCE=/tmp/solco-git-evidence GOTOOLCHAIN=auto go test ./internal/nativeui -run 'Evidence'

Releasing: a vX.Y.Z tag equal to mygo.config.ts's version builds and signs the app in CI (the MYGO_UPDATER_PRIVATE_KEY secret) and uploads a draft release. Releases and the site live at github.com/thewei/solco-git and thewei.github.io/solco-git.

Working next to Solco

go.mod requires github.com/thewei/solco-gitkit at a tagged version and never replaces it with a relative path: CI sees only this repository. On a machine that has the repositories side by side, an uncommitted go.work (it is gitignored) makes the local copy win:

go work init . && go work edit -replace github.com/thewei/solco-gitkit=../solco-gitkit

The LazyGit-backed Git capabilities live in solco-gitkit's nested engine module (internal/nativeui/git_backend.go), so the work file also lists it: go work use ../solco-gitkit/engine. Publishing order: tag solco-gitkit (vX.Y.Z), then engine/vX.Y.Z, then GOWORK=off go get github.com/thewei/solco-gitkit/engine@vX.Y.Z && go mod tidy here (the tag is engine/vX.Y.Z; go get takes the bare version). (Published: gitkit v0.3.0, engine v0.1.0.) SOLCOGIT_GIT_BACKEND=argv runs everything on plain git again.

solco-gitkit is public (github.com/thewei/solco-gitkit, tagged v0.1.0), so CI here needs no credential.

The UI kit (theme, components, icons, the Git review and Files presentation) started as a copy of Solco's internal/nativeui. scripts/kit-parity.sh lists, per shared file, whether the two copies are still identical (--all) or how far they differ, and --diff <file.go> shows one file; it needs the sibling ../solco checkout (SOLCO_DIR when it is elsewhere). The 2026-11-14 menus (Rewrite History, the Actions additions, Co-authors / Reset author, Compare Two Commits) exist only here: Solco keeps just its Changes / Files lists, so the drift is deliberate and is not synced back.

Opening a repository from outside

solcogit://open?repo=/absolute/path&view=changes|commits|files&file=path/inside/the/repo
open -a "Solco Git" /path/to/a/folder

repo must be an absolute path (a file stands for the folder it is in; the repository root is resolved); view and file are optional (a file without a view opens Files; with view=changes the file is selected in the Changes list, and a path that is not changed selects nothing). A link longer than 8192 bytes, with a NUL, or without a repository is refused. A link that arrives before the window exists waits for it. The parameters are never logged.

Keyboard

Key Action
⌘O Open Repository…
⇧⌘O Quick Launch
⌘W Close Window (hides it, the workspaces stay)
⇧⌘] / ⇧⌘[ Next / previous workspace
⌃⇥ / ⌃⇧⇥ Next / previous workspace (Window menu — on macOS only a visible menu item can carry Control-Tab)
⌘[ / ⌘] Back / Forward through the workspaces and views you have been to (also the arrows at the sidebar's right edge)
⌘1 ⌘2 ⌘3 Changes, Commits, Files
⌘R Refresh
⌘B Toggle sidebar
⌘, Settings

Data and logs

Preferences are one file, settings.json (atomic write, mode 0600), in MyGo's per-app user-data directory: the appearance and density switches, a few workbench cosmetics (auto-fetch interval, split diff, hidden refs, folded merges, ref-tree folds, Hide Stashes), and the window's workspaces (repository path and view), recents and sidebar width. Nothing else is stored: no credentials, no commit messages, no diffs.

Logs are structured and size-bounded under MyGo's PathLogs (2 MiB active + 3 backups). They carry operation names, counts, errors and timing; never repository paths, commit messages, diffs, file contents, credentials or the parameters of a solcogit:// link. (SOLCOGIT_LOG_LEVEL=debug is opt-in and adds one line that names the repository root of a snapshot refresh.) An unpackaged go tool mygo dev run uses its own name (Solco-Git-dev), so its data and logs stay apart from the installed app's.

Known limits

  • Built on upstream MyGo v0.8.1. Solco's vendored fork carries patches for its terminal, tray and a WebView bridge crash after tens of thousands of page messages; none is carried here. A WebView appears in two places only: the Open Preview window for an HTML file (a loopback page, no message bridge), and a page of a few hundred bytes that shows an AVIF or ICO file (built in Go, no script, stylesheet file or network, created when such a file is picked and destroyed when another is).
  • Markdown past 2 MiB reads as source; a long document shows as rows of a virtual list, so opening cost follows what is in view, not the file. In the rendered view a remote image never loads (a document makes no network request) and an image shows only when it stands alone in its paragraph. Raw HTML is translated into what the view can draw — no colours, widths or row spans, <details> always open, scripts, styles, frames, forms and media dropped; math and Mermaid are drawn in Go within fixed size and time bounds and fall back to their source with the reason; emoji shortcodes are not drawn. Find does not search raw-HTML blocks, math or diagrams, and Esc closes its bar only while the field has the focus (Done otherwise).
  • A workspace refreshes and auto-fetches only after it was first shown this session; one you switch back to is re-read at once.
  • Quick Launch has no ⇧↵ (open in a new window): there is one window.

License

MIT © 2026 Wilson.

The rendered Markdown view links three Go modules that keep their own licenses (full texts ship in the module sources): github.com/go-tex/math v0.50.0 (BSD-3-Clause, © 2026 the go-tex/math authors; embeds STIX Two Math, SIL OFL 1.1, © 2001–2021 The STIX Fonts Project Authors, https://github.com/stipub/stixfonts), tuios.dev/sketch v0.4.0 (MIT, © 2026 kepano and Gaurav Gosain; embeds subsets of Arimo 1.33, SIL OFL 1.1, © 2026 The Arimo Project Authors, https://github.com/googlefonts/Arimo, and Go Mono, © 2016 Bigelow & Holmes Inc., BSD-3-Clause) and golang.org/x/net v0.59.0 (BSD-3-Clause, © The Go Authors).

The commit graph's layout and drawing (internal/nativeui/git_commit_graph.go) follow TanGit (MIT, © 2026 FleetingEcho), which in turn ports the pipe-set layout of LazyGit (pkg/gui/presentation/graph, MIT, © 2018 Jesse Duffield). The LazyGit command layer that solco-gitkit's engine module links is MIT as well.

About

Native macOS Git client with a Files viewer (Go, MyGo Native UI)

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages