Skip to main content

Gitmoot v0.3.1-beta.1

Gitmoot v0.3.1-beta.1 ships the presence-layer work that makes new Codex and Claude sessions start with useful local Gitmoot context, plus the dashboard bug-report workflow added after the v0.3.0 dashboard beta.

Highlights​

SessionStart presence context​

  • Generated Codex and Claude plugin packages now include a read-only SessionStart hook manifest.
  • The hook injects repo identity, Gitmoot home, version/build metadata, and a compact local snapshot of daemon, task, job, and branch-lock state.
  • Snapshot reads use the Gitmoot SQLite store in read-only mode and fail open, so a missing or locked local store does not block runtime startup.
  • Agents are guided to answer health/status questions directly from the snapshot or read-only CLI checks, and mention gitmoot dashboard only as an optional live-monitoring follow-up.

Plugin install and diagnostics​

  • gitmoot plugin doctor now validates generated hook manifests for Codex and Claude packages.
  • gitmoot plugin codex-launch prints a Codex launch command with --add-dir <gitmoot-home> so sandboxed Codex sessions can read local Gitmoot state without using full sandbox bypasses.
  • The plugin docs and bundled skill now call out valid read-only status commands and avoid nonexistent commands such as gitmoot status --json and gitmoot task show.

Dashboard bug reports​

  • The dashboard can open a redacted bug-report preview for failed, blocked, or cancelled jobs and create or reuse a matching GitHub issue.
  • The report builder includes job context, recent events, labels, and a fingerprint marker for duplicate detection.
  • Follow-up fixes tightened the busy-state shortcut and preview behavior.

Validation​

  • GOTOOLCHAIN=go1.26.0 go test ./internal/presence ./internal/plugincontext ./internal/cli
  • gitmoot plugin doctor
  • gitmoot plugin hook-context smoke from /root/gitmoot
  • gitmoot plugin codex-launch --repo /root/gitmoot
  • codex-face exec --cd /root/gitmoot --add-dir /root/.gitmoot --dangerously-bypass-hook-trust -s workspace-write ...

Known Limits​

  • The SessionStart snapshot is intentionally compact. Use gitmoot dashboard --json, gitmoot task list --repo owner/repo --json, or other read-only CLI commands when an agent needs full detail.
  • Codex plugin validation is still limited by the installed Codex CLI; plugin doctor reports this as a warning when validation is not exposed.
  • Claude background jobs still need non-interactive Claude credentials in the daemon environment.