Fast, local-first Git desktop client, code intelligence suite, and task workspace.
Review changes with GPU acceleration, resolve 3-way conflicts, follow branch and commit history, search across repositories, organize tasks with board swimlanes, and inspect repository health from a native Rust / Tauri 2 app with a Svelte 5 frontend. 100% on-device, private-by-design, zero telemetry.
Download · Getting started · Documentation · Website · Release notes · v2.0 Beta notes
GitPulse 2.0 (currently in beta on main as 1.99.0 — the first release since v1.3.1, rolling in all unpublished v1.4.0 and v1.5.0 changes; see the v2.0 release notes) brings a redesigned desktop shell, out-of-process terminal and agent hosting, pre-operation Git recovery snapshots, and full multi-agent worktree orchestration:
- Streamlined 4 views & 11 sections with floating glass cards:
- Work (
Overview · Remote · Tasks): Inline 3-way conflict editor leading Overview whenever a merge or rebase is parked, plus folded stale-branch cleanup with tip backups, policy activity, outgoing-commit checks, and release tag publishing. - Code (
Explorer · Map): Inline Search (git grep) and Blame toggles inside Explorer, and a Map overview of repository size, caps, and critical files with[n/5]live build progress and hover tooltips across files, symbols, and subsystems. - History (
Graph · Diff): UnifiedCommits | HEAD moves | Suspectsswitcher on Graph, a History (⌥H) commit-graph rail tab right inside Diff, rich commit hover cards (full message body,git notes, recorded verification), andShift+clickolder..newercommit-to-commit comparisons. - Insights (
Pulse · Coverage · Health · Storage): Kingfisher redacted Secrets folded into Health under one health verdict, five-row previewed report lists (Show all N), and Storage on-demandgit commit-graph write.
- Work (
- Theme preset gallery, saved themes shelf & macOS window wallpapers: Seventeen built-in
gitpulse-theme/1presets across Standard (Neural HUD, Reactor, Pure Black, Crimson, Phosphor, Synthwave, Paper), Developer (Amber CRT, Blueprint, Midnight IDE, Arctic, Solar Dark, Daylight), and Sci-Fi (Nebula, Orbital, Neon City, Hyperspace); a My themes shelf for up to 24 saved or imported themes; and eleven seeded static SVG backdrops or custom raster wallpapers (<= 2560pxJPEG in IndexedDB, macOS only). - Stacked worktree tabs & collapsible repository groups: Every checkout of a repository shares one tab with a checkout switcher, and inactive repository groups (and inactive tabs within groups) can collapse from the tab bar, Settings, or Command Palette.
- Always-on Unix terminal host (
gitpulse-ptyd), WebGL rendering & hosted Manvi runs: PTY terminal sessions on Unix unconditionally live ingitpulse-ptyd(Terminal host) with transcript recovery (512 KiB), a durable 64-row session ledger (terminal-sessions.v1.jsonl,TerminalResume --fork), default-on detachedmanvi serve --listenhosting for managed Codex and Claude runs, GPU WebGL rendering (@xterm/addon-webglwith 5-minute context hold and 3-strike DOM fallback), DEC 2026 synchronized output,@xterm/addon-unicode11, kernel-event exit waiting, and Send to agent live-session wakeups (gitpulse-hook deliver). - Pre-operation Git snapshots (
refs/gitpulse/ops/<n>) & agent turn checkpoints (refs/gitpulse/turns/): Allowed agent Git mutations record pre-operation snapshots with CAS-checked undo (cmd_undo_op_snapshot) in Reflog, while opt-in turn checkpoints capture working-tree state at agent turn start and end (inspectable over MCP viagitpulse_turn_checkpoints). - Zero-copy agentic worktrees, Claude Code hooks, Codex ledger & live MCP control plane: Eleven
gitpulse_worktree_*MCP tools,gitpulse-worktreeCLI,gitpulse-rustcbuild cache,.worktreeinclude, andWorktreeCreate/WorktreeRemoveplugin hooks provisionclaude --worktreeand isolated subagents with CoW-seeded DevMap stores (~1.2 squery-ready vs~7.6 scold).gitpulse_sessionsandagents.livereport live Claude Code, Codex, Antigravity, DevCouncil, and Manvi sessions (0gitspawns ongitpulse_sessions), alongside Codex rollout ledger ingestion, per-run activity timelines, agent thread trees,gitpulse_merge_conflicts,gitpulse_landed,gitpulse_provenance, and inode-bound ledger adoption. - Workbench schema 17 & faster Tasks board: Merges the Inbox column into Backlog (five columns: Backlog, Ready, In progress, Review, Done), adds cross-repo queues, a two-way GitHub issue sync outbox, and DAG launch readiness, automatically fills board columns up to 2,000 cards (
fillBoard), refreshes live while the window is on screen even when unfocused (liveOnScreen), and adds a two-row header, subtask progress, due-date/status filters, attention inbox dismiss/restore, card merge/delete,expected_revisionCAS protection ongitpulse_add_task, and CI watching on agent branches. - Manvi Anthropic account registry, host-load governor, Firebase diagnostics & PR review: Launches
manvi servevia~/.anthropic-accounts(anthropic-account exec --no-fallback) withCloud · <model>pill display, governs agent launches under severe host memory pressure (sysload::governor) with class-tiered Git spawn budgets (spawn-budget.v2), adds GitHub PR review/approve/merge actions, classifies Firebase App Hosting CLI failures with redacted Copy diagnostics, renders GitHub commit author avatars in Graph, and expandsdc-redactsecret detection (ya29.,1//,GOCSPX-, GitLabgldt-/glft-/glrt-/glwt-, Slackxoxe-, AWSABIA/ACCA/A3T, HuggingFaceapi_org_).
- Install GitPulse and Git for your platform.
- Open a repository and review Trust and Open. Trust allows its hooks, helpers, and project tools to run with your account permissions.
- Use Work for changes in flight, History to review a commit, and
Code to explore files. Open the command palette with
⌘K/Ctrl+K. - Replay the guided tour any time from Settings → Appearance → Guided walkthrough.
GitHub CLI, DevMap, Manvi, and local model servers are optional; install the ones needed for the features you use. The first repository guide walks through a review, task creation, and optional setup.
If you installed the packaged desktop app, Settings → Agents → Connect (or its Copy setup prompt) symlinks the bundled gitpulse-mcp and gitpulse-hook into ~/.local/bin without needing a source checkout or Rust toolchain, and Help → Set Up Optional Tools installs DevMap, the analysis suite, or Manvi interactively.
To build and wire up GitPulse, DevCouncil (devmap, dcstore, dcverify, dcgrep, devcouncil), Manvi (manvi), and MCP integrations from source (requires Git, Bun 1.4.2, Rust 1.100+, and Go 1.27.4+), paste this prompt into Claude Code, Codex, Antigravity, or Cursor (or run the fenced commands directly):
Install and wire up the complete GitPulse, DevCouncil, Manvi, and MCP toolchain on this machine, then verify every binary, schema, and host integration without skipping failing checks:
1. Preflight tools and checkouts:
- Confirm `git`, `bun`, `rustc`/`cargo`, and `go` are on `PATH` (and `~/.local/bin` / Cargo / Go bin dirs are reachable).
- Check whether sibling `GitPulse`, `DevCouncil`, and `Manvi` checkouts already exist; otherwise ask where to clone `https://github.com/bharathvbcr/GitPulse.git` (and optionally `DevCouncil` / `Manvi`), and do not install system packages outside Cargo/Go/Bun user bins without asking.
2. Install GitPulse MCP, hooks, and worktree/cache CLIs (`gitpulse-mcp`, `gitpulse-hook`, `gitpulse-worktree`, `gitpulse-rustc`):
- From a `GitPulse` checkout (or after `git clone https://github.com/bharathvbcr/GitPulse.git && cd GitPulse`):
```sh
bun install --frozen-lockfile
bun run mcp:install
cargo install --path crates/gitpulse-worktree --locked --force
```
- Skip rebuilding `gitpulse-mcp` / `gitpulse-hook` from source if I already linked them from the packaged app via Settings -> Agents -> Connect in `~/.local/bin`.
3. Install all DevCouncil components (`devmap`, `dcstore`, `dcverify`, `dcgrep`, `devcouncil`):
- If a local `DevCouncil` checkout is present, run `bash scripts/install.sh`; otherwise install from GitHub:
```sh
cargo install --git https://github.com/bharathvbcr/DevCouncil.git --locked --force devmap-cli
cargo install --git https://github.com/bharathvbcr/DevCouncil.git --locked --force --bin dcstore dc-store
cargo install --git https://github.com/bharathvbcr/DevCouncil.git --locked --force --bin dcverify dc-verify
cargo install --git https://github.com/bharathvbcr/DevCouncil.git --locked --force --bin dcgrep dc-grep
go install github.com/bharathvbcr/DevCouncil/backend/go_orchestrator/cmd/devcouncil@latest
```
4. Install Manvi (`manvi` policy harness, workbench host, and managed agent runner):
- From a local `Manvi` checkout run `go -C manvi install ./cmd/manvi`, or install remotely:
```sh
go install github.com/bharathvbcr/Manvi/manvi/cmd/manvi@latest
```
5. Configure MCP servers and agent plugins cleanly (preview before writing; preserve existing user-owned configs):
- Register **either** the GitPulse plugin (`plugins/gitpulse/` for Claude Code/Codex/Cursor or `plugins/gitpulse-agy/` for Antigravity) **or** a direct `gitpulse` MCP registration (`gitpulse-mcp`), **never both** — the plugin already registers the `gitpulse` server (repo insights, worktree coordination, collision radar, task board, and in-process `devmap_*`).
- Run `devmap integrate <host> --dry-run` (and `devcouncil integrate <host> --dry-run` if using the orchestrator MCP) for my active agent client(s) (`claude`, `codex`, `cursor`, `antigravity`), show me the planned file changes (noting any `not_ours` protected files), and apply only with my approval (`--apply`) so `devmap mcp` (code graph) and `devcouncil mcp` (orchestrator/leases) sit cleanly alongside `gitpulse-mcp`.
6. Verify end-to-end and report exact tool outputs:
```sh
bun run mcp:doctor
bun run check:schema-parity
devmap doctor && devcouncil doctor && manvi doctor
dcstore --version && dcverify --version && dcgrep --help >/dev/null
```
- Ensure `mcp:doctor` reports matching digests for `gitpulse-mcp` and `gitpulse-hook`, and `check:schema-parity` agrees across vendored crates, `devmap`, `dcstore`, `gitpulse-mcp`, and `manvi`.
- In the target repository, run `devmap paths --json` and `devmap status --json` (and `devmap build --manifest` if missing or stale).
Report what succeeded, what could not run, exact paths of installed binaries, and any MCP/plugin config changes made or awaiting approval.
GitPulse has 4 application views with 11 specialized sections. Each view keeps related sections together.
| View | What you do here | Sections |
|---|---|---|
| Work | Track work in flight, resolve conflicts, organize tasks | Overview · Remote · Tasks |
| Code | Browse, search and blame files, explore structure | Explorer (with Search and Blame toggles) · Map |
| History | Follow commits, review changes, find recovery points | Graph (commits, HEAD moves — the reflog — or regression suspects) · Diff |
| Insights | Inspect activity, coverage, dependencies, secrets, and disk usage | Pulse · Coverage · Health · Storage |
Graph's three lists and Diff share the selected commit; Explorer and Blame share the selected file; Overview embeds branch stack hierarchy. Fleet compares repositories across the workspace (scaling to 1,000 repositories with 24 active watches), Tasks opens global and saved-workspace boards with swimlanes and WIP limits, and the terminal dock stays available across views.
- Review and commit. Canvas commit graph (100K+ commits at 60/120 FPS), unified and side-by-side diffs, word highlighting, symbol-grouped diff hunks, image comparisons, selective staging, stash previews, a three-way conflict resolver, and structured patch-brief commit phrasing with on-device Apple Intelligence fallback.
- Manage worktrees and branches. Zero-round-trip branch churn carry-forward on branch mutations,
DevMap-guided
--conesparse worktrees,<512 Bzero-copy DevMap base pointers with Blake3/CAS delta overlays, copy-on-write dependency cache sync (node_modules,target,.venv) plus lock-freegitpulse-rustc(RUSTC_WRAPPER) shared CoW crate caching, parallel agent coordination bus and 3-layer CSR/ODB collision radar (gitpulse-worktreeCLI &gitpulse-mcp), dead-branch cleanup with durable WAL tip backups and authorized delete actions, macOS pre-exec background QoS band isolation, named localhost routes via portless, and trust-gated lifecycle hooks. - Organize the work. Quick add parses priority, labels, owner, repository, due date, and notes. Board views with swimlanes (grouped by owner or label), saved views, column WIP limits, column "Load all" paging up to 2,000 cards with persistent reload depth, named hidden repository notices, task checklists with done states, cross-task links (parent, blocks, related, duplicate), the Archive dock with Deleted recovery, review drafting suggestions, and agent terminal handoff with per-launch model selection.
- Explore and search the code. File navigation and blame are built in. High-speed
repository-wide text search (
git grepover working tree or revisions with honest cancellation and truncation reporting). Add DevMap for structural navigation, symbol search, symbol-level collision detection, dependencies, impact, and candidate tests. - Inspect the repository. Universal coverage reports across 6 formats (LCOV, Cobertura,
Go cover, Istanbul, JaCoCo, Clover), multi-ecosystem dependency audits (
cargo-audit,npm audit,pip-audit,govulncheck) withcargo denyandcargo crevparsers, Kingfisher redacted secrets scanning that locates each finding against Git, storage cleanup previews, and Pulse activity summaries distinguish results from scans that did not run. Capped results identify their limits. - Work from the desktop. Native menus, a command palette (
⌘K), a docked PTY terminal with expanded view isolation, WebGL context caching, DEC 2026 frame synchronization, and configurable bell prompts that reports what each session is running, reflog recovery (reset --keep), GitHub pull request actions (review, comment, approve, merge pinned to viewed commit), colour-coded repository tabs and collapsible inactive groups that survive a restart, and an optional macOS menu-bar status popover keep frequent actions close. Background windows stop their timers instead of polling.
The feature reference describes each surface and its limits. The changelog records release changes; open qualification tracks remaining platform, provider, and performance checks.
| File explorer | Diff review |
|---|---|
![]() |
![]() |
| Coverage | Dependency health |
![]() |
![]() |
Screenshots are captures from the macOS app; appearance varies by release and platform.
Repository and task state are stored locally. The desktop app has no remote telemetry. Git remotes, GitHub operations, Firebase App Hosting checks you ask for, optional tool downloads, release checks, and configured agent providers can use the network.
Built-in local AI connects to loopback model servers. Task enhancement and agent runs use their configured provider; supported Mac builds can also use Apple Intelligence for task titles and descriptions. These are distinct execution paths.
Repository trust is an execution decision. A worktree is not an OS sandbox. Policy verdicts preserve unchecked separately from allowed, and the MCP server cannot grant repository trust. Read the security and trust model before configuring agents.
DevCouncil is components and modules. Manvi wraps them. GitPulse uses Manvi for policy, workbench, and agent hosting, and selected DevCouncil components for code intelligence. Modules can be updated independently.
flowchart TB
subgraph Frontend["Svelte 5 Frontend (Runes & TS)"]
direction LR
Views["4 Views · 11 Sections<br/>(Work, Code, History, Insights)"]
Canvas["GPU HTML5 Canvas<br/>Commit Graph"]
TerminalDock["PTY Terminal Dock<br/>(portable-pty)"]
end
subgraph IPC["Tauri 2 IPC Seam"]
Bridge["invoke('cmd_*') — 331 Handlers<br/>Zero-Drift Pre-Commit & CI Contracts"]
end
subgraph Backend["Rust Backend (Tauri 2 / Rayon)"]
direction TB
GitEngine["Git Sandbox & CLI Reader"]
LaneSolver["Topological Lane Solver"]
Analyzers["Coverage, Health & LOC"]
Ledger["Durable WAL Event Ledger"]
Headless["Headless Binaries<br/>(gitpulse-mcp · gitpulsed · gitpulse-hook · gitpulse-ptyd)"]
end
subgraph Integrations["Modular Integrations & Local Tools"]
direction TB
subgraph ManviWrap["Manvi (Wraps DevCouncil Modules)"]
ManviSidecar["manvi serve --posture host<br/>(5-verdict policy gate & workbench DB)"]
end
subgraph DevCouncilMods["DevCouncil & DevMap"]
Vendored["Vendored Readers<br/>(devmap-store, devmap-query, dc-store)"]
DevMapCLI["devmap CLI & daemon socket<br/>(build --manifest, search, impact)"]
end
subgraph LocalTools["Local Machine"]
CLI["git & gh CLI"]
LocalLLM["Loopback-Only LLMs<br/>(Ollama / LM Studio)"]
end
end
Frontend --> Bridge
Bridge --> Backend
Backend --> ManviWrap
Backend --> DevCouncilMods
Backend --> LocalTools
See architecture for ownership and contracts, and module integration for the boundaries between projects. GitPulse succeeds the deprecated LiquiTask workbench; this does not imply complete feature parity.
Use Bun 1.4.2, Node.js 22.x (22.12 or newer), Rust 1.100+ (stable), Go 1.27.4 (for gusset:check), Git, and your platform's native
build tools. The contributor guide covers setup and platform prerequisites.
git clone https://github.com/bharathvbcr/GitPulse.git
cd GitPulse
bun install --frozen-lockfile
git config core.hooksPath .githooks
bun run tauri dev| Command | Purpose |
|---|---|
bun run check |
Svelte and TypeScript checks |
bun run test |
Frontend and contract tests |
bun run test:tz |
Local-time frontend tests across America/New_York, Pacific/Auckland, and Asia/Kolkata |
bun run check:ipc |
Match frontend calls to the native command registry |
bun run check:types |
Compare Rust and TypeScript wire contracts |
bun run check:release |
Check version manifest consistency |
bun run check:workflows |
Lint the GitHub Actions workflow definitions |
bun run test:browser:all |
Browser regressions under headless Chrome |
bun run test:webkit:all |
The same regressions under WKWebView (macOS only) |
bun run build |
Build the frontend bundle |
bun run tauri build |
Build native bundles for the host |
bun run ci:local |
The gates in scripts/ci-local.mjs: contracts, both renderers, format, clippy, Rust and frontend tests, coverage floors and the gusset check. It deletes the ~50 GiB instrumented coverage build when it is done with it; set CI_LOCAL_KEEP_COVERAGE_BUILD=1 to keep it. It does not run bun audit, cargo deny (bun-audit.yml), the Go vet and -race jobs, the scheduled deep and parallel-test workflows, or the Linux and Windows builds, which only CI runs |
The browser regressions run twice in CI — under Chrome on Linux and under
WKWebView on macOS — because the two engines disagree often enough to matter: a
fixture can pass under one and fail under the other. ci:local runs both for
that reason, so prefer it over the individual commands before opening a pull
request.
A frontend build alone does not qualify the native application. Follow the release procedure before publishing a build.
The documentation index organizes user guides, integration references, contributor contracts, and historical evidence. Start with installation, your first repository, feature reference, tasks and workspaces, or zero-copy agentic worktrees.
Bug reports, documentation, design, tests, and code contributions are welcome. See CONTRIBUTING.md and good first issues.
Questions and open-ended proposals go to Discussions — ask in Q&A, where an answer can be marked accepted, or start in Ideas. Bugs, scoped feature requests, and adapter proposals go through issues, which has a template for each. Suspected vulnerabilities are the exception: report those through GitHub Security Advisories as described in the security and trust model, not as a public issue.
The bug template asks for a diagnostics report: open the command palette and run Open Diagnostics, then use its copy button, which collects the version, platform, and recent log lines. Read it before pasting — it can contain repository paths.
Every kind of contribution is recognised here, not only code — documentation,
design, bug reports, testing, reviews, and ideas all count under the
all-contributors
specification. The list below is generated from .all-contributorsrc.
To add someone (including yourself), comment on any issue or pull request:
@all-contributors please add @username for code, doc
The bot opens a pull request updating this section and .all-contributorsrc.
See the emoji key for contribution
types.
| Category | Metadata / Values |
|---|---|
| GitHub Topics | git, git-client, git-gui, tauri, tauri-v2, rust, svelte5, svelte, local-first, code-intelligence, developer-tools, devtools, desktop-app, mcp, commit-graph, merge-conflict-resolver, reflog, test-coverage, terminal, privacy-first, zero-telemetry |
| Tech Stack | Rust (Tauri 2, Rayon), Svelte 5 (Runes), TypeScript, Tailwind CSS, portable-pty, DevMap, Manvi |
| Target Platforms | macOS (Apple Silicon & Intel Universal dmg), Linux (.AppImage, .deb), Windows (.msi, .exe) |
| License & Privacy | MIT License · 100% on-device · Zero telemetry |
Distributed under the MIT License. See NOTICE for third-party and vendored crate attributions. The GitPulse name and logo are not covered by the MIT License; see TRADEMARKS.md.
- The Tauri Programme (
tauri-apps) (tauri,wry,tao,muda— Apache-2.0 OR MIT) — Desktop shell runtime and patched crates undersrc-tauri/framework/. - webkit2gtk-rs (
The Gtk-rs Project Developers&Antoni Boucher, MIT), libappindicator-rs (Kyle Machulis / qDot), and notify (Félix Saparelli & contributors). - MarkDev (
bharathvbcr/MarkDev, MIT) — Embedded Rust Markdown/math/diagram rendering pipeline undersrc-tauri/vendor/markdev/.
© 2026 Bharath Chandra Vaddaram





