Gitmoot v0.1.0-beta.7

Gitmoot v0.1.0-beta.7

Gitmoot v0.1.0-beta.7 unifies planner usage around one planner agent template and adds current-chat prompt import for Gitmoot agents and templates.

Features

• Added gitmoot agent prompt <agent-or-template> for read-only current-chat prompt import.
• gitmoot agent prompt --json <agent-or-template> prints prompt content plus metadata for tooling.
• Registered agents now resolve before templates with the same name, so use review-fe here can load the configured agent's template.
• The same planner template now supports both current-chat usage and managed/background Gitmoot agent usage.
• Retired the separate public planner-here template to remove the confusing split between planner modes.
• Old cached planner-here rows are hidden or blocked from template list/show/diff/update/import paths and managed background startup.
• Updated README, skills, docs, website docs, plugin packaging expectations, and LLM context for the unified planner model.

Example

Install or refresh the planner template:

gitmoot agent template update planner
gitmoot agent prompt planner

Use the planner in the current Codex or Claude chat:

Use the Gitmoot planner here. Write a task-by-task implementation plan and goal file.

Use a custom agent prompt in the current chat:

gitmoot agent template add frontend-reviewer --file agents/frontend-reviewer.md
gitmoot agent subscribe frontend-reviewer \
  --runtime codex \
  --session last \
  --template frontend-reviewer \
  --role reviewer \
  --capability ask \
  --capability review

gitmoot agent prompt frontend-reviewer

Retired planner path:

gitmoot agent prompt planner-here
# agent template planner-here is retired; use planner

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.
• The plugin packages teach Codex and Claude how to use Gitmoot, but the Gitmoot CLI remains the execution engine.
• Current-chat prompt import is prompt reuse, not true system-prompt injection.
• There is no hosted dashboard, GitHub App bot identity, cloud runner, billing, or remote control plane.
• Windows binaries are not included in this beta because daemon process management currently uses Unix-specific process controls.
• Local agent ask is implemented; local agent review and agent implement remain follow-up work.

Assets

• gitmoot_linux_amd64
• gitmoot_darwin_amd64
• gitmoot_darwin_arm64
• SHA256SUMS

Verification

• git diff --check
• /root/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.2.linux-amd64/bin/go test ./...
• GITMOOT_BIN=/tmp/gitmoot-release-v0.1.0-beta.7/gitmoot_linux_amd64 scripts/plugin-smoke.sh
• Release binary version metadata check with gitmoot_linux_amd64 version --json
• Release binary smoke for agent template update planner, agent prompt planner, custom template prompt import, registered agent prompt import, and retired planner-here rejection

Gitmoot v0.1.0-beta.6

Gitmoot v0.1.0-beta.6

Gitmoot v0.1.0-beta.6 replaces the public preset model with agent templates and ships the renamed planner workflow on top of the existing local-first agent coordination runtime.

Features

• Replaced public preset terminology with agent templates across CLI, skills, docs, plugin packaging, job prompts, and PR comment attribution.
• Added gitmoot agent template add|list|show|update|diff for built-in and local custom prompt templates.
• Removed the public gitmoot preset command and --preset / --update-preset flags.
• Renamed the built-in planner templates:
  • gitmoot-plan-and-goal -> planner
  • gitmoot-plan-lite -> planner-here
• Moved packaged planner instructions to skills/gitmoot/agent-templates/.
• Updated managed background agent type config to use template = "...".
• Added compatibility for existing beta state: legacy config preset keys, old preset tables, and old job payload preset_* fields are read and migrated or mapped internally.

Example

Install or refresh the planner template:

gitmoot agent template update planner
gitmoot agent start project-planner \
  --runtime codex \
  --repo owner/repo \
  --path . \
  --template planner \
  --start-daemon

Fast planning in the current chat:

Use the Gitmoot planner here. Write a task-by-task implementation plan for this feature.

Custom prompt template:

gitmoot agent template add frontend-reviewer --file agents/frontend-reviewer.md
gitmoot agent start frontend-reviewer \
  --runtime codex \
  --repo owner/repo \
  --template frontend-reviewer \
  --role reviewer \
  --capability ask \
  --capability review

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.
• The plugin packages teach Codex and Claude how to use Gitmoot, but the Gitmoot CLI remains the execution engine.
• There is no hosted dashboard, GitHub App bot identity, cloud runner, billing, or remote control plane.
• Windows binaries are not included in this beta because daemon process management currently uses Unix-specific process controls.
• Local agent ask is implemented; local agent review and agent implement remain follow-up work.

Assets

• gitmoot_linux_amd64
• gitmoot_darwin_amd64
• gitmoot_darwin_arm64
• SHA256SUMS

Verification

• git diff --check
• /root/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.2.linux-amd64/bin/go test ./...
• GOTOOLCHAIN=local /root/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.2.linux-amd64/bin/go vet ./...
• GO_BIN=/root/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.2.linux-amd64/bin/go scripts/plugin-smoke.sh
• npm run typecheck in website
• npm run build in website
• Release binary version metadata check with gitmoot_linux_amd64 version --json
• Post-merge built-in template update smoke for planner and planner-here

Gitmoot v0.1.0-beta.5

Gitmoot v0.1.0-beta.5

Gitmoot v0.1.0-beta.5 clarifies the agent execution model and adds the background execution primitives needed for practical multi-agent workflows.

Features

• Added runtime session locks so Gitmoot does not resume the same Codex or Claude session from two jobs at the same time.
• Added gitmoot agent ask <agent> --background ... for queued local agent asks that return immediately.
• Added gitmoot job watch <job-id> to follow job events until completion.
• Added managed background agent types with gitmoot agent type list|show|set, max_background, idle_timeout, and gitmoot agent gc.
• Added the lightweight gitmoot-plan-lite preset for fast current-chat planning.
• Split planner UX into two clear paths:
  • here: current Codex or Claude chat reads Gitmoot skill/preset guidance and answers directly.
  • background: Gitmoot creates a tracked job and runs it through the daemon/runtime adapter path.
• Updated CLI, plugin, smoke-test, website, and Agent Skill docs for here vs background, session-lock waits, and conservative worker guidance.
• Centralized queued-job resource selection for repo checkout and runtime-session scheduling.

Example

Fast planning in the current chat:

Use the Gitmoot planner here. Write a task-by-task implementation plan for this feature.

Tracked background planner job:

gitmoot preset update gitmoot-plan-and-goal
gitmoot agent start planner \
  --runtime codex \
  --repo owner/repo \
  --path . \
  --preset gitmoot-plan-and-goal \
  --start-daemon

gitmoot agent ask planner --repo owner/repo --background "Write the implementation plan and goal file."
gitmoot job watch <job-id>

Managed background planner type:

gitmoot preset update gitmoot-plan-lite
gitmoot agent type set planner \
  --runtime codex \
  --preset gitmoot-plan-lite \
  --role planner \
  --capability ask \
  --max-background 2 \
  --idle-timeout 20m

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.
• The plugin packages teach Codex and Claude how to use Gitmoot, but the Gitmoot CLI remains the execution engine.
• There is no hosted dashboard, GitHub App bot identity, cloud runner, billing, or remote control plane.
• Windows binaries are not included in this beta because daemon process management currently uses Unix-specific process controls.
• Local agent ask is implemented; local agent review and agent implement remain follow-up work.

Assets

• gitmoot_linux_amd64
• gitmoot_darwin_amd64
• gitmoot_darwin_arm64
• SHA256SUMS

Verification

• git diff --check
• /root/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.2.linux-amd64/bin/go test ./...
• /root/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.2.linux-amd64/bin/go vet ./...
• GO_BIN=/root/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.2.linux-amd64/bin/go scripts/plugin-smoke.sh
• Release binary version metadata check with gitmoot_linux_amd64 version --json

Gitmoot v0.1.0-beta.4

Gitmoot v0.1.0-beta.4

Gitmoot v0.1.0-beta.4 adds the local registered-agent ask path and the planner preset workflow, so plugin-guided chats can invoke real Gitmoot agents instead of using a parallel skill-only planning path.

Features

• New gitmoot agent ask <agent> "message" [--repo owner/repo] [--json] command.
• Local agent asks use the same registered agent, repo access grants, cached preset snapshot, runtime adapter, mailbox, job history, and gitmoot_result contract as PR-comment ask jobs.
• Added the gitmoot-plan-and-goal built-in planner preset for structured implementation plans and standard goal-file prompts.
• Added gitmoot goal template for the canonical PR-per-task goal prompt.
• Updated Codex and Claude plugin guidance so local chat planner workflows route through gitmoot agent ask planner ....
• Added shared local dispatch helpers to prepare for future local agent review and agent implement commands.
• Expanded smoke documentation for local planner asks, PR-comment planner asks, and plugin packaging.

Example

gitmoot preset update gitmoot-plan-and-goal
gitmoot agent start planner \
  --runtime codex \
  --repo owner/repo \
  --path . \
  --preset gitmoot-plan-and-goal

gitmoot agent ask planner --repo owner/repo "Write a task-by-task implementation plan and goal-file prompt."

From a Codex plugin command bridge:

$gitmoot:gitmoot agent ask planner --repo owner/repo "Write the implementation plan and goal file."

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.
• The plugin packages teach Codex and Claude how to use Gitmoot, but Gitmoot CLI remains the execution engine.
• There is no hosted dashboard, GitHub App bot identity, cloud runner, billing, or remote control plane.
• Windows binaries are not included in this beta because daemon process management currently uses Unix-specific process controls.
• Local agent ask is implemented; local agent review and agent implement are tracked as follow-up work.

Assets

• gitmoot_linux_amd64
• gitmoot_darwin_amd64
• gitmoot_darwin_arm64
• SHA256SUMS

Verification

• git diff --check
• /root/temp/ts/tool/go test ./...
• /root/temp/ts/tool/go vet ./...
• Release binary version metadata check with gitmoot_linux_amd64 version --json

Gitmoot v0.1.0-beta.3

Gitmoot v0.1.0-beta.3

Gitmoot v0.1.0-beta.3 adds local Codex and Claude plugin packaging on top of the local-first beta workflow.

Features

• New gitmoot plugin command group:
  • gitmoot plugin build codex|claude
  • gitmoot plugin install codex|claude
  • gitmoot plugin doctor [codex|claude]
  • gitmoot plugin path codex|claude
• Generates runtime plugin packages from the canonical skills/gitmoot Agent Skill.
• Codex plugin packages include .codex-plugin/plugin.json, bundled skill files, and local marketplace metadata.
• Claude plugin packages include .claude-plugin/plugin.json, bundled skill files, and local marketplace metadata.
• plugin install can install Gitmoot into local Codex and Claude plugin marketplaces, while returning manual commands if a runtime CLI is missing.
• Plugin doctor reports package paths, manifest state, copied skill state, runtime CLI state, marketplace state, and validation commands.
• Added plugin documentation in docs/plugins.md, README, beta smoke tests, local workflow docs, and agent-facing skill references.
• Added scripts/plugin-smoke.sh for isolated plugin build/install smoke coverage.
• Gitmoot is now packaged as a spec-aligned Agent Skill under skills/gitmoot while preserving the root SKILL.md entrypoint.

Example

gitmoot plugin install codex
gitmoot plugin doctor codex

gitmoot plugin install claude
gitmoot plugin doctor claude

Then ask the agent to use Gitmoot from chat:

Use the Gitmoot skill. Check gitmoot status for this repo.

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.
• The plugin packages teach Codex and Claude how to use Gitmoot, but Gitmoot CLI remains the execution engine.
• There is no hosted dashboard, GitHub App bot identity, cloud runner, billing, or remote control plane.
• Windows binaries are not included in this beta because daemon process management currently uses Unix-specific process controls.

Assets

• gitmoot_linux_amd64
• gitmoot_darwin_amd64
• gitmoot_darwin_arm64
• SHA256SUMS

Verification

• /root/temp/ts/tool/go test ./...
• /root/temp/ts/tool/go vet ./...
• git diff --check
• Release binary version metadata check with gitmoot_linux_amd64 version --json

Gitmoot v0.1.0-beta.2

Gitmoot v0.1.0-beta.2

Gitmoot v0.1.0-beta.2 adds preset-backed agent startup and local custom prompt agents on top of the first local-first beta.

Features

• gitmoot agent start can create new Codex and Claude runtime sessions without leaving an interactive terminal open.
• Runtime startup now uses adapter-owned contracts, keeping Codex and Claude behavior behind the runtime layer.
• Codex session health/resume checks now resolve shell snapshot session records more reliably.
• Built-in preset support for thermo-nuclear-code-quality-review, including explicit update/diff commands and prompt snapshots in queued jobs.
• Agents can bind to installed presets so startup prompts and PR-comment jobs include cached preset instructions.
• Local custom prompt presets with:
  • gitmoot preset add <preset-id> --file <path>
  • gitmoot preset list/show/update/diff <preset-id>
  • sha256:<hash> content identifiers
  • snapshot-at-add/update behavior for reproducible queued jobs
• Updated SKILL.md, README, workflow docs, adapter docs, troubleshooting, and beta smoke tests for custom prompt agents.
• Install guidance is now included in the agent skill docs.

Example

mkdir -p agents
printf '%s\n' 'Review frontend changes for correctness, regressions, responsiveness, and missing tests.' > agents/frontend-reviewer.md

gitmoot preset add frontend-reviewer --file agents/frontend-reviewer.md

gitmoot agent start frontend-reviewer \
  --runtime codex \
  --repo owner/project \
  --path . \
  --preset frontend-reviewer \
  --role reviewer \
  --capability ask \
  --capability review \
  --start-daemon

Then ask from a PR comment:

/gitmoot frontend-reviewer review

After editing the prompt file, refresh the cached snapshot explicitly:

gitmoot preset diff frontend-reviewer
gitmoot preset update frontend-reviewer

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.
• Windows binaries are not included in this beta because daemon process management currently uses Unix-specific process controls.

Assets

• gitmoot_linux_amd64
• gitmoot_darwin_amd64
• gitmoot_darwin_arm64
• SHA256SUMS

Verification

• GOTOOLCHAIN=go1.26.0 go test ./...
• GOTOOLCHAIN=go1.26.0 go vet ./...
• git diff --check
• Release binary version metadata check with gitmoot_linux_amd64 version --json
• Local custom-preset smoke subset: build, preset add, preset show, preset diff, preset update, and preset-backed shell agent subscribe

Gitmoot v0.1.0-beta.1

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.

Assets

• gitmoot_linux_amd64
• gitmoot_darwin_amd64
• gitmoot_darwin_arm64
• SHA256SUMS

Windows binaries are not included in this beta because daemon process management currently uses Unix-specific process controls.

Verification

• GOTOOLCHAIN=go1.26.0 go test ./...
• GOTOOLCHAIN=go1.26.0 go vet ./...
• git diff --check
• Live one-repo smoke test on #25
• Live two-repo smoke test on #25 and jerryfane/codex-session-sync#1