Migrating from 1.x to 2.x

2.x replaces slash commands with Agent Skills. Your plans and tasks are fully compatible – no changes needed.

1. Delete obsolete slash commands

Delete whichever directories exist for harnesses you used:

rm -rf ".claude/commands/tasks/" \
  ".gemini/commands/tasks/" \
  ".codex/prompts/tasks-*" \
  ".github/prompts/tasks-*.prompt.md" \
  ".cursor/commands/tasks/" \
  ".opencode/command/tasks/"

2. Delete obsolete config scripts

rm -f .ai/strikethroo/config/scripts/*.cjs
rmdir .ai/strikethroo/config/scripts 2>/dev/null

3. Re-initialize the workspace

npx strikethroo@latest init --harnesses claude

Replace claude with your harness(es), e.g. claude,gemini,opencode.

4. Install the workflow skills

npx skills add e0ipso/strikethroo

What changed

1.x 2.x
Slash commands (per-harness) Agent Skills (harness-agnostic)
.cjs scripts in config Bundled into skills
claude-exec CLI subcommand Removed

What didn’t change

  • .ai/strikethroo/plans/ and archive/ are unchanged
  • All plan and task markdown files work as-is
  • Hooks and templates in .ai/strikethroo/config/ are preserved
  • STRIKETHROO.md project context is preserved

This site uses Just the Docs, a documentation theme for Jekyll.