Skip to content

Say how to use the plugin: one claude --worktree session per task - #4

Merged
Marius1311 merged 2 commits into
mainfrom
docs/usage
Oct 12, 2026
Merged

Marius1311 merged 2 commits into
mainfrom
docs/usage

Conversation

@Marius1311

Copy link
Copy Markdown
Member
  • README: a Use section (start each task with claude --worktree <task> from the main checkout; what happens; what stays with the human). Install points at the quadbio marketplace, the one place the commands live.
  • The session-start rules and the skill name the same command, so an agent in a main checkout can tell the human how to start a task.

Merging this, then tagging v0.2.0, completes the release that #3 started.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vtrv52oTpCLDMKzN13i4Nw

The README gains a Use section and points at the marketplace for the install commands. The session-start
rules and the skill name the same command, so an agent in the main checkout can tell the human how to start
a task.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vtrv52oTpCLDMKzN13i4Nw
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-12T10:45:58.244635Z 6f0bf99 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6f0bf998ce

ℹ️ About Codex in GitHub

Your team has set up Codex to 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 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread README.md Outdated
Comment on lines +20 to +23
Start each analysis task as its own session, from the analysis repo's main checkout:

```bash
claude plugin marketplace add quadbio/claude-plugins
claude plugin install analysis-workflow@quadbio
claude --worktree <task>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Sync main before starting the task worktree

When the local main checkout is behind or ahead of origin, launching this command from it does not ensure that the task uses that checkout's revision: Claude Code's default fresh mode will “branch from your repository’s default branch on the remote”. The task can therefore contain a newer pixi.toml while the workflow executes it using the stale main checkout environment, or it can omit unpushed setup changes. Require a clean, up-to-date main checkout before this command (or explicitly configure worktree.baseRef: "head") so the task code and shared environment stay aligned.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in cc5fac0: the Use section now says to pull the main checkout first, since the worktree branches from origin's default branch but runs on the main checkout's environment. Not switching to worktree.baseRef: "head": starting from the merged default branch is what we want; the stale main checkout is the thing to fix.

claude --worktree branches from origin's default branch, while the task runs on the main checkout's
environment; a stale main checkout pairs new code with an old environment.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vtrv52oTpCLDMKzN13i4Nw
@Marius1311
Marius1311 merged commit e0b06dd into main Oct 12, 2026
3 checks passed
@Marius1311
Marius1311 deleted the docs/usage branch October 12, 2026 11:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant