v0.1.2 Release by zippoxer · Pull Request #4 · zippoxer/subtask

zippoxer · 2026-01-21T18:33:07Z

Summary

Major release focused on git workflow improvements and correctness.

Git Redesign (Primary)

PR-style diffs: Uses merge-base..head instead of live diffs - stable across rebases, matches GitHub behavior
"Applied" detection: Detects squash merges and cherry-picks via content comparison (merge-tree simulation)
"Missing" UX: Clear indicator when task branch is deleted but task not merged
Frozen stats: Stats recorded at merge/close time - merged tasks show correct data forever
Commit logging: Commits are logged to history.jsonl with timestamps
No-op merge finalize: subtask merge works when content is already in base

Migration

Automatic one-time migration from v0.1.1 schema
Backfills base_commit into task.opened events
Backfills frozen stats into task.merged/task.closed events
Uses schema versioning for fast skip on subsequent runs
Global marker prevents re-running migration on every command
Preserves correct timestamps (uses git commit dates, not migration time)

Send & Interrupt Fixes

Concurrency guards: Block concurrent sends to the same task
SIGINT handling: Proper cleanup during early claim phase
Interrupted output: Print 'interrupted' to stderr on signal (not stdout)

Merge Improvements

Uncommitted changes: subtask merge now works when base worktree has uncommitted changes
Conflict detection fix: Fixed merge-tree conflict detection edge cases

Review Command

--base flag: PR-style review of current branch against any base
Prompt building: Build review prompts on subtask side instead of passing flags to codex

Other Changes

Codex harness fix: Transient network errors no longer cause false failures
Claude model aliases: Config now uses opus/sonnet instead of full model IDs
Skill outdated warning: Warn when project-scoped skill is older than bundled version
Install UX improvements: Better flags, dynamic guide, cleaner output
Release flow: Interactive release with beta support

Test plan

go test ./... passes
Migration tested on real repos
Verified sort order preserved after migration
Tested "applied" detection with squash-merged tasks
Verified frozen stats display for merged tasks
Send concurrency e2e tests
Interrupt e2e tests

🤖 Generated with Claude Code

* migrate: golden legacy fixtures + cleanup repo runtime * Merge branch 'main' into refactor/install-config-ux * tests+docs: cover new setup UX and runtime paths * cli: add config command, preflight requirements, remove init * core: git-root anchoring, global runtime, centralized migration Subtask-Task: refactor/install-config-ux

* test: add setup UX e2e coverage Subtask-Task: test/setup-ux-gaps

* Fix false merge detection for no-commit tasks Subtask-Task: fix/false-merge-detection

* test: add thorough layout migration tests Subtask-Task: test/migration-thorough

* Run legacy plugin migration once via marker * Test: preserve complex settings during migration * Remove broken plugin install; add install --guide Subtask-Task: review/install-cleanup

The --guide flag is meant for Claude Code to read and follow, not for humans. Rewrite the output to be structured instructions similar to what the old setup.md contained.

The --guide flag is for Claude Code to read and follow, not for humans. Rewrite output to be structured instructions explaining what Subtask is, what setup does, and how to guide the user afterward.

…tput - Add --harness, --model, --reasoning, --max-workspaces flags to install/config - Add --scope flag for user vs project skill installation - Make --guide output dynamic based on environment (git repo, available harnesses) - Improve guide language: "spawn subagents" instead of "dispatch parallel AI workers" - Show consistent config details after install/config (Scope, Harness, Model, etc.) - Fix git.Output() to not log expected "not a git repo" errors - Add InstallToProject() for project-scoped skill installation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add validation and e2e tests for install UX flags Subtask-Task: review/install-ux

Change scope options from technical terms to user-friendly language: - "User — available in all projects" → "Globally (recommended)" - "Project — only this repository" → "This project only" Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* refactor(config): extract pure resolve/validate/build Subtask-Task: refactor/config-pure-functions

- Show current state (latest stable, latest beta) before prompting - Ask user which version to create with concrete options - Support beta releases from dev branch - Auto-increment beta numbers (v0.2.0-beta.1 → beta.2) - Mark betas as prerelease to exclude from auto-update - Skip Homebrew verification for beta releases Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

cloudflare-workers-and-pages · 2026-01-21T18:33:21Z

Deploying subtask with Cloudflare Pages

Latest commit:	`591f654`
Status:	⚡️ Build in progress...

View logs

Clarify options when trying to send to a working task: - You'll be notified when done, can send more context after - To correct a worker going wrong direction: interrupt && send Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

zippoxer · 2026-01-22T08:59:12Z

@codex

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 47717b7041

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector · 2026-01-22T09:08:42Z

+	if err != nil || homeDir == "" {
 		return
 	}

-	userRes, err := install.AutoUpdateIfInstalled(install.ScopeUser, userBase)
+	res, err := install.AutoUpdateIfInstalled(homeDir)


Update project-scope skills during auto-update

If a user installed the skill with subtask install --scope project (still supported), the skill lives under the repo’s .claude/skills/subtask/SKILL.md, but runAutoUpdate now only calls install.AutoUpdateIfInstalled for the home directory, so project-scoped installs will never get refreshed and can drift to stale instructions even though auto-update runs.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-01-22T09:08:42Z

 func (c *StatusCmd) Run() error {
-	userBase, _, err := baseDirForScope(install.ScopeUser)
+	st, err := install.GetSkillStatus()
 	if err != nil {


Report project-scope installs in status output

subtask status now only checks install.GetSkillStatus() (user scope), so in the scenario where the skill was installed with --scope project the command will incorrectly report “not installed/up-to-date,” which makes status output inaccurate for that supported install mode.

Useful? React with 👍 / 👎.

- Change git repo warning from error (✗) to warning (⚠) since install works without one - Clarify "you'll need one later to create tasks" - Guide Claude to use judgment on git init (don't offer in ~ or /) - Fix proof link in README to use markdown format Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add --base flag to subtask review Subtask-Task: review/add-base-flag

yangwao · 2026-01-22T13:40:57Z

time to add patreon:)

Design docs for the new task freshness approach: - Historical diffs (GitHub-style, not live) - Ancestor-only merge detection - Commit logging to history (PR-style timeline) - Simplified store access layer Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix(harness/codex): ignore transient error events on success * docs: document codex harness error latching Subtask-Task: fix/codex-network-error

- Change default Claude model from "claude-opus-4-5-20251101" to "opus" - Change Sonnet option from full ID to "sonnet" - Claude Code resolves aliases internally Also add issue doc for history write timing concern. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Git redesign: PR-style diffs, applied detection, frozen stats, migration Subtask-Task: impl/git-redesign

…mestamps * Fix gitredesign migration timestamps Subtask-Task: fix/migration-timestamps

* Warn when project-scoped skill is outdated Subtask-Task: fix/project-skill-autoupdate

* Add send --async and wait command Subtask-Task: feature/async-send-wait

Ensures async output file contains explicit interrupt message. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix merge-tree conflict detection Subtask-Task: fix/merge-conflict-detection

* Allow merge fast-forward with dirty base worktree Subtask-Task: fix/merge-with-uncommitted

* test: add v0.1.1 fixtures for gitredesign * perf: skip gitredesign migration after first run Subtask-Task: perf/skip-completed-migration

Removes --async flag, wait command, and related state fields. Keeps SKILL.md improvements (delegate guidance, task=branch clarification). Includes concurrency guard fixes that need review. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Build review prompt in subtask for codex Subtask-Task: fix/review-prompt-design

* fix(send): handle SIGINT during early claim * fix(send): clear state before output and block concurrent sends Subtask-Task: review/async-revert

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

# Conflicts: # README.md

Split former zippoxer#7 (guardrails over escape hatches) into two distinct goals: errors at subtask's own boundaries are actionable, and destructive operations require explicit intent. They were really doing different work — every error site vs. specific commands — and bundling them obscured both. Removes the embedded "doesn't yet do" TODO that was accreting in the design doc. Extend zippoxer#4 (workspace opacity) to make the isolation model explicit: git-level only; runtime resources (ports, services, databases) are project-managed and shared by default. Surfaced after a discovered incident where workers tested against the lead's dev server and reported false positives. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

zippoxer and others added 12 commits January 21, 2026 04:40

test: add setup UX e2e coverage

1194564

* test: add setup UX e2e coverage Subtask-Task: test/setup-ux-gaps

fix: prevent false merge detection for tasks with no commits

b36abfe

* Fix false merge detection for no-commit tasks Subtask-Task: fix/false-merge-detection

test: add thorough layout migration tests

b10837d

* test: add thorough layout migration tests Subtask-Task: test/migration-thorough

Remove broken plugin install, add migration for legacy users

0a8f34f

* Run legacy plugin migration once via marker * Test: preserve complex settings during migration * Remove broken plugin install; add install --guide Subtask-Task: review/install-cleanup

fix: make --guide output agent-readable instructions

77afa95

The --guide flag is meant for Claude Code to read and follow, not for humans. Rewrite the output to be structured instructions similar to what the old setup.md contained.

fix: make --guide output agent-readable instructions

2a23eb7

The --guide flag is for Claude Code to read and follow, not for humans. Rewrite output to be structured instructions explaining what Subtask is, what setup does, and how to guide the user afterward.

Add validation and e2e tests for install UX flags

cc144fd

* Add validation and e2e tests for install UX flags Subtask-Task: review/install-ux

refactor: extract config merge/validate logic into pure functions

7c0fb56

* refactor(config): extract pure resolve/validate/build Subtask-Task: refactor/config-pure-functions

improve "task is still working" error message

47717b7

Clarify options when trying to send to a working task: - You'll be notified when done, can send more context after - To correct a worker going wrong direction: interrupt && send Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

zippoxer added 2 commits January 22, 2026 11:03

Update README.md

8380733

Update README.md

dbf2d6f

chatgpt-codex-connector Bot reviewed Jan 22, 2026

View reviewed changes

zippoxer and others added 6 commits January 22, 2026 11:13

Update README.md

ad43ed6

Update README.md

e62a8ba

Update README.md

eb52071

Update installation instructions in README.md

137191a

feat(review): add --base flag for PR-style branch diff reviews

cfef833

* Add --base flag to subtask review Subtask-Task: review/add-base-flag

zippoxer force-pushed the dev branch from 33e9e39 to 7fc8e3e Compare January 24, 2026 15:12

zippoxer and others added 3 commits January 24, 2026 17:33

Fix Codex harness returning transient errors on success

7380d34

* fix(harness/codex): ignore transient error events on success * docs: document codex harness error latching Subtask-Task: fix/codex-network-error

Git redesign: PR-style diffs, applied detection, frozen stats, migration

f6a62b1

* Git redesign: PR-style diffs, applied detection, frozen stats, migration Subtask-Task: impl/git-redesign

zippoxer and others added 17 commits January 25, 2026 18:30

Fix migration corrupting sort order by using commit dates for zero ti…

2d4efc5

…mestamps * Fix gitredesign migration timestamps Subtask-Task: fix/migration-timestamps

Warn when project-scoped skill is outdated

9b7d866

* Warn when project-scoped skill is outdated Subtask-Task: fix/project-skill-autoupdate

Merge main into dev: fix Codex transient errors on success

4b03bf7

Add send --async and wait command

6cb1f1b

* Add send --async and wait command Subtask-Task: feature/async-send-wait

Print 'interrupted' to stderr on signal in send

6c80523

Ensures async output file contains explicit interrupt message. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Fix merge-tree conflict detection

819533e

* Fix merge-tree conflict detection Subtask-Task: fix/merge-conflict-detection

Update SKILL.md

68d354d

Update .gitignore

55c2af8

Allow subtask merge with uncommitted changes in base worktree

5c7cdc9

* Allow merge fast-forward with dirty base worktree Subtask-Task: fix/merge-with-uncommitted

Update SKILL.md

17cae96

Update SKILL.md

97e1a37

Add global marker to skip gitredesign migration after first run

d561dce

* test: add v0.1.1 fixtures for gitredesign * perf: skip gitredesign migration after first run Subtask-Task: perf/skip-completed-migration

Revert async send/wait feature

65bd829

Removes --async flag, wait command, and related state fields. Keeps SKILL.md improvements (delegate guidance, task=branch clarification). Includes concurrency guard fixes that need review. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Build review prompts on subtask side instead of passing flags to codex

b2c882c

* Build review prompt in subtask for codex Subtask-Task: fix/review-prompt-design

Fix async revert: proper concurrency guards, optimal ordering, e2e tests

7b60a4c

* fix(send): handle SIGINT during early claim * fix(send): clear state before output and block concurrent sends Subtask-Task: review/async-revert

Add early development note to README

57782f4

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Merge remote-tracking branch 'origin/main' into dev

591f654

# Conflicts: # README.md

zippoxer merged commit 255293b into main Jan 29, 2026
1 check was pending

zippoxer deleted the dev branch January 29, 2026 23:29

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

v0.1.2 Release#4

v0.1.2 Release#4
zippoxer merged 42 commits intomainfrom
dev

zippoxer commented Jan 21, 2026 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages Bot commented Jan 21, 2026 •

edited

Loading

Uh oh!

zippoxer commented Jan 22, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Uh oh!

chatgpt-codex-connector Bot Jan 22, 2026

Uh oh!

chatgpt-codex-connector Bot Jan 22, 2026

Uh oh!

yangwao commented Jan 22, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

zippoxer commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Git Redesign (Primary)

Migration

Send & Interrupt Fixes

Merge Improvements

Review Command

Other Changes

Test plan

Uh oh!

cloudflare-workers-and-pages Bot commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying subtask with Cloudflare Pages

Uh oh!

zippoxer commented Jan 22, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Jan 22, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Jan 22, 2026

Choose a reason for hiding this comment

Uh oh!

yangwao commented Jan 22, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

zippoxer commented Jan 21, 2026 •

edited

Loading

cloudflare-workers-and-pages Bot commented Jan 21, 2026 •

edited

Loading