Skip to content

Repository files navigation

Guito

Explore and manage Git repositories in a focused visual client. Guito runs locally in your browser or directly inside Visual Studio Code.

The name combines GUI and Git: GuITo. It is also a Portuguese word for money.

npm package · VS Code extension · Issue tracker

Features

  • Visual commit graph with branch and tag references.
  • Stashes listed in the commit table with apply, pop, and drop actions.
  • Commit search by subject, body, author, or hash, with loading feedback and retries.
  • Local and remote branch filtering.
  • Commit and working-tree diffs powered by the Monaco editor, with inline and side-by-side layouts.
  • Fetch, pull, pull with rebase, push, and sync actions.
  • Context actions for creating branches and tags, checking out commits, cherry-picking, reverting, merging, rebasing, resetting, and exporting archives.
  • Working-tree actions for stashing changes, resetting tracked changes, and cleaning untracked files.
  • Stage and unstage files with multi-selection, preview staged and unstaged diffs, and commit staged changes.
  • Review your active Azure DevOps pull requests from the repository side panel: edit details, manage reviewers and votes, complete or auto-complete, discuss comment threads, and add inline comments on file diffs.
  • Browser-based CLI and a VS Code extension with local, Remote SSH, Dev Container, and Codespaces support.

Caution

Guito can run destructive Git operations, including hard resets, commit drops, forceful cleanup, and history changes. Review confirmation dialogs carefully and make sure important work is committed or backed up.

Quick start

Browser client

You need Git, Node.js 20 or newer, and npm. From inside the repository you want to inspect, run:

npx guito

Guito starts a local server at http://localhost:8080 and opens it in your default browser.

To install the command globally instead:

npm install --global guito
guito

Visual Studio Code

After installing the extension, open a trusted workspace containing a Git repository, then either:

  • select Guito in the status bar; or
  • run Guito: Open Guito from the Command Palette.

In a multi-root workspace, Guito asks which repository to open. Git must be available on the local or remote VS Code extension host.

Stage and commit changes

Click Uncommitted changes to open the staged and unstaged file lists. Click to select a file, Ctrl/Cmd-click to toggle individual files, or Shift-click to select a range. Use the per-file buttons, selected-file actions, or Stage all / Unstage all. The separate Diff button previews only the changes in that list.

Enter a commit message and optional description, then choose Commit staged changes. Only staged changes are committed; unstaged edits remain on disk. Commit drafts stay available when you close and reopen the panel during the session.

CLI options

guito [--port <number>] [--no-open]
Option Description
--port <number> Port used by the local server. Defaults to 8080; use 0 to select an available port automatically.
--no-open Start the server without opening a browser.

Run the command from anywhere inside the Git worktree you want Guito to manage. Press Ctrl+C in the terminal to stop the server.

Using Guito

  • Select a commit to inspect its changed files, then select a file to open its diff.
  • Select Uncommitted changes to inspect the working tree.
  • Use the branch selector and remote-branch toggle to narrow the graph.
  • Right-click a commit, reference badge, or the working-tree row to open its available Git actions.
  • Use the toolbar for remote operations and manual refreshes.

The standalone server can execute Git commands against the current repository. Keep it on a trusted machine and do not expose its port to untrusted networks.

Development and contributing

See CONTRIBUTION.md for local setup, development commands, project structure, testing, and pull-request guidance.

Release history is maintained in CHANGELOG.md.

License

Guito is available under the MIT License.

About

Easily explore your git repositories.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages