# ZoneGaze Git Plugin

## Role

First-party Matrix plugin for device Git setup and repository work.

## Source Boundaries

- Public Matrix entrypoint: `plugins/git/src/matrix.ts`
- Runtime Git behavior: `flow/runtime/src/workspace/git-device.ts`

## Current Capability Signals

- Capability registry: `git`
- Runtime/package status: `ready`

## Major Features

- Device Git and SSH setup
- Repository status/history/sync actions
- Shared project repository access for Matrix modules
- Optional `lazygit` detection without bundling

## Current Matrix Coordination

- `Flow`: Git reuses Flow runtime Git helpers and complements Flow's review/worktree workflow.
- `Code`: edit in Code, then inspect repository status, history, fetch/pull/push, or SSH/device
  setup from Git.
- `Chat`, `Joplin`, `Open Design`, and `Research`: Git is intended to be the shared repository
  layer so project-facing plugins refer to the same repository state instead of owning separate Git
  logic.

## Related Docs

- [Plugin README](../../plugins/git/README.md)
- [Flow runtime](../../flow/runtime/README.md)
- [Matrix plugin coordination](plugin-coordination.md)
