Sidecat Agents use git.status, git.diff, git.show, git.log, and git.branch to understand a repository before acting.
Native Git
Git work should be inspectable before it becomes trust.
Sidecat now exposes git through a native operation catalog instead of treating repository work as anonymous shell glue. The line covers local observations, typed local transitions, and governed external effects.
This page describes the public support surface. The protected commit and push path still runs through sidecatd, credential custody, evidence references, and receipts.
Work path
Observe locally, change deliberately, publish with receipts.
Agents use git.add and git.restore for typed local staging and un-staging instead of relying on loose shell transcripts.
Agents use git.commit, git.push, and git.remote.read for evidence-bound commits, credential-custodied pushes, and remote parity.
Catalog
Native operations cover the working loop.
git.status
Reads the current branch, short status entries, ahead/behind state, and cleanliness without changing the worktree.
git.diff
Reads bounded unified diffs for unstaged, staged, or HEAD scope, with truncation reported instead of hidden.
git.show
Reads one git object through bounded output so an agent can inspect a commit, tag, or blob without shell scraping.
git.log
Reads newest-first commit history as structured commits, with bounded body output and optional path filtering.
git.add
Stages explicit pathspecs and returns the post-add status snapshot so staging is recorded as a typed operation.
git.restore
Restores explicit pathspecs from the index, worktree, or both, then returns the post-restore status snapshot.
git.branch
Reads current HEAD, detached state, local branches, optional remote-tracking refs, upstreams, and tracking text.
git.commit
Creates an evidence-bound commit through sidecatd with work id, actor, reason, branch guard, and receipt output.
git.push
Publishes a governed commit through purpose-scoped credential custody and records the external effect receipt.
git.remote.read
Reads a remote branch through connector custody, optionally checking the expected SHA after a governed push.
Sidebird
The operation catalog is exported with the public snapshot.
Sidebird renders the operation catalog and one detail page per operation from sidecatd descriptors, so a reader can inspect schemas, summaries, effect classes, owners, and templates without needing the local daemon.