Skip to content

Home

Jump to bottom
thitichaya edited this page Jun 12, 2026 · 13 revisions

Helix Wiki

Canonical docs: README on GitHub on main. This wiki mirrors docs/wiki/Home.md.

Version: 1.5.29 · VERSION · Releases: releases

What is Helix?

Portable QA skill pack for AI coding agents (Agent Skills / SKILL.md):

  • TC FE prep — manual test cases from Jira story AC/EC (coverage + ISTQB/29119-3 quality review, optional Test Type column, CSV/Excel/Test.md, Jira post-publish verification, four-axis final review report)
  • TC API prep — manual test cases from API spec + Swagger (spec coverage + quality review, row ordering, CSV/Excel/Test.md, post-publish verification)
  • Testing ticket — Playwright on one Jira ticket
  • Retest bug — verify fix, post evidence, transition
  • Create bug — file issues on Jira or GitHub

Not tied to one vendor — same skills in Claude Code, Cursor, Copilot, Gemini CLI, Windsurf, Cline, Codex, and more.

Full agent list: Supported-AI-Agents · supported-agents.md on GitHub

TC prep delivery: CSV/Excel (default), Jira comment + attachment, optionally Test.md for agent hand-off (test-md-format.md).

Supported AI agents (summary)

Agent Global folder after install Start Helix
Claude Code ~/.claude/skills/ + plugin helix@helix /helix or /tc-fe-prep, …
Cursor ~/.cursor/skills/ @helix or skill helix
Codex ~/.codex/skills/ skill helix
GitHub Copilot ~/.copilot/skills/ skill helix in chat
Gemini CLI ~/.gemini/skills/ /skills list → helix
Windsurf ~/.codeium/windsurf/skills/ @helix
Cline ~/.cline/skills/ skill helix
OpenCode ~/.config/opencode/skills/ per tool docs
Pi ~/.pi/agent/skills/ per tool docs
Cross-agent ~/.agents/skills/ shared alias

Prompts: agent-entry.md

Install (one-time)

See Installation for per-agent steps.

curl -sL https://raw.githubusercontent.com/Thitic9203/helix/main/scripts/install.sh | bash

Installer does: clone ~/.helix/tc-fe-prep, symlink skills, enable helix@helix (disable legacy helix@local), register SessionStart hooks (bootstrap + auto-update).

Agent After install
Claude Code New session → /helix
Cursor Reload Window → @helix
Copilot / Cline / Gemini / Codex skill helix

Health check:

bash ~/.helix/tc-fe-prep/scripts/helix-doctor.sh
HELIX_DOCTOR_FIX=1 bash ~/.helix/tc-fe-prep/scripts/helix-doctor.sh   # repair

Team repo (optional):

HELIX_LINK_WORKSPACE=$PWD ~/.helix/tc-fe-prep/scripts/link-skills.sh

Usage

You do not have to start with /helix. Call a workflow directly when you know the goal; use /helix or skill helix only for the menu.

Goal Claude Code Other agents
FE test cases /tc-fe-prep tc-fe-prep-workflow
API test cases /tc-api-prep tc-api-prep-workflow
Retest bug /retest-bug retest-bug-workflow
Test ticket /testing-ticket testing-ticket-workflow
Create bug /create-bug create-bug-workflow
Menu (optional) /helix skill helix

Details: Commands-Reference

Update — auto-update (default)

You usually do not need to run git pull. After install, Helix checks GitHub main for a newer VERSION when you start a new session (at most every 4 hours).

Trigger Action
New Claude Code / Cursor session helix-auto-update.sh
git pull in ~/.helix/tc-fe-prep post-merge hook → sync plugin + symlinks
Setting Meaning
HELIX_AUTO_UPDATE=0 Turn off auto-update
HELIX_FORCE_UPDATE=1 Run check immediately
Log ~/.helix/auto-update.log

Manual fallback:

HELIX_FORCE_UPDATE=1 bash ~/.helix/tc-fe-prep/scripts/helix-auto-update.sh

Claude plugin: use helix@helix only — not helix@local (legacy, auto-disabled).

Full detail: README — Update

Workflow docs (on GitHub)

Workflow Source
Router helix
TC FE tc-fe-prep-workflow
TC API tc-api-prep-workflow
Retest retest-bug-workflow
Testing ticket testing-ticket-workflow
Create bug create-bug-workflow

More links

Home

Clone this wiki locally