chronicle-rebind-variation-git

Rebinds an open Chronicle variation from a code bundle to a pushed git ref.

1|1|Updated May 9, 2026
One-click install
npx skills add https://github.com/methodic-research/skills --skill chronicle-rebind-variation-git-methodic-research
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chronicle-rebind-variation-git
Source: https://github.com/methodic-research/skills/tree/main/plugins/chronicle/skills/rebind-variation-git
Command: npx skills add https://github.com/methodic-research/skills --skill chronicle-rebind-variation-git-methodic-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a Chronicle experiment variation was created with a bundled code artifact but you later pushed your code to a branch in the experiment's git repo, you need to switch the variation's code source without recreating it. This Skill binds the pushed git ref to the open variation and removes the now-stale bundle, so the variation carries exactly one code source. ## Core Features & Use Cases - Git ref binding: Calls chronicle.set_variation_git_ref to point an open variation at a branch, tag, or SHA already pushed to the experiment repo. - Bundle cleanup: Finds every code_artifact input via chronicle.list_variation_inputs, unlinks it, and hard-deletes the orphaned asset. - State safety checks: Verifies the variation is still open before mutating, since binding and input cleanup freeze at commit. - Use Case: You created variation 3 with chronicle-bundle-variation, then pushed a variation/3 branch to the experiment repo. Run this Skill to bind that branch and drop the bundle, then commit the variation to pin the SHA and create run 0 against the git code. ## Quick Start Switch variation 3 of my current Chronicle experiment to use the pushed variation/3 git branch instead of its code bundle.

Frequently Asked Questions about chronicle-rebind-variation-git

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch a Chronicle variation from a bundle to a git branch?▼

Push your code to a branch in the experiment's repo, then bind it with chronicle.set_variation_git_ref and clean up the old code_artifact bundle via unlink_variation_input and delete_asset. The variation must still be open, since binding freezes at commit.

How do I change a variation's code after it is committed?▼

You cannot rebind a committed variation because git-ref binding and input cleanup freeze at commit. Instead, create a new variation with chronicle-fork-variation, which forks the committed variation so you can attach new code.

Does rebinding a variation to git require the Python SDK?▼

No. This is a CRUD operation that uses the bundled Chronicle MCP tools directly with credentials from ~/.methodic. The methodic-research SDK (version 0.28 or later) is only an optional alternative path.

Why does binding a git ref fail with an agent namespace error?▼

The agent/* branch namespace is protected and reserved for the Chronicle App, so set_variation_git_ref rejects it. Push your code to a variation/<id> branch or another plain branch and bind that ref instead.

What happens if the bundle asset cannot be deleted after unlinking?▼

If delete_asset is refused because you did not create the asset or it is still linked elsewhere, the unlink still succeeded and the asset is simply orphaned. Note it and use the chronicle-delete-asset skill to remove it later.