Git

git() exposes bounded Git inspection and selected local Workspace Session state changes. Use it for review, source-history inspection, and local branch selection, not for publishing repository history.

Installation

Import the Capability factory from @vite-hub/agent/capabilities and add it to defineAgent({ capabilities }). The Agent must use a git-capable Workspace Session.

What it adds

The Capability adds git_read in read mode. In write mode it also adds git_write for a narrow set of local git operations.

Configuration

import { defineAgent } from '@vite-hub/agent'
import { git } from '@vite-hub/agent/capabilities'

export default defineAgent({
  driver: { model },
  workspace,
  capabilities: [
    git({ mode: 'read' }),
  ],
})

Runtime behavior

git_read accepts one git command without shell composition. Read mode allows source-history commands such as status, diff, log, show, grep, and ref inspection.

git_write supports only fetch, checkout, and switch on a clean working tree. It blocks commit, push, reset, rebase, tag, arbitrary remote URLs, shell composition, and path escapes outside the Workspace.

Requirements

git() requires a Workspace primitive that can start a Workspace Session. The Workspace requirement is write-mode because ViteHub may need session-local Git state even when the exposed tool mode is read-only.

Driver support

Options

Inspect and verify

Inspect the Agent tool list in DevTools. Run git status --short through git_read, then verify unsupported commands such as git push are rejected.

Reference

• Workspace
• Workspace shell
• Source: packages/agent/src/capabilities/git.ts