# Gitmoot v0.1.0-beta.1

Gitmoot v0.1.0-beta.1 is the first local-first beta for coordinating AI agent
sessions through GitHub pull requests.

## Features

- Local SQLite workflow state for repos, agents, goals, tasks, jobs, PRs, and
  branch locks.
- Runtime-neutral agent registry with Codex, Claude Code, and shell adapters.
- Multi-repo daemon mode for watching all enabled repositories from one
  Gitmoot home.
- Repo-scoped agent access so one global agent identity can work across
  multiple allowed repos without cross-routing.
- PR comment commands for help, status, agent ask/review/implement jobs, merge
  requests, retries, and cancellation.
- Background daemon management with start, run, stop, restart, status, and logs.
- Worker loop that executes queued jobs, records raw output locally, advances
  workflow state, and posts attributed PR result comments.
- Branch lock commands for inspecting and releasing stale implementation locks.
- Job recovery commands for listing, showing, retrying, cancelling, and
  inspecting job events.
- Version and update commands backed by GitHub Releases, with conservative
  manual fallback commands when self-update is not safe.
- Agent-facing `SKILL.md` covering Gitmoot commands, output contracts, and safe
  behavior rules.
- Live smoke-test documentation for one-repo and two-repo local workflows.

## Known V1 Limits

- Gitmoot runs locally; the daemon host must stay online.
- GitHub is polled; there is no webhook receiver in this beta.
- PR comments are authored by the authenticated GitHub user, with agent
  attribution in the comment body.
- There is no hosted dashboard, GitHub App bot identity, cloud runner, billing,
  or remote control plane.
- GitHub Checks are not used in V1; Gitmoot uses PR comments and commit
  statuses where appropriate.
