Installation

Canonical install steps also live in the README. Agent matrix: Supported-AI-Agents.

Step 1 — Everyone (same command)

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

This clones Helix to ~/.helix/tc-fe-prep, symlinks workflow skills into global agent folders, and registers the Claude Code plugin cache.

Agent / IDE	After the install script	Optional: skills in your git repo
Claude Code	Open project → `/helix`	`HELIX_LINK_WORKSPACE=$PWD ~/.helix/tc-fe-prep/scripts/link-skills.sh`
Cursor	Reload window → `@helix`	Same workspace command
Codex	Run in project folder → skills auto-discovered	Same
GitHub Copilot	Enable Agent Skills → skill helix	Recommended: workspace link → `.github/skills/`
Gemini CLI	`gemini` → `/skills list` → helix	Workspace link → `.gemini/skills/`
Windsurf	`@helix` in Cascade	Workspace link → `.windsurf/skills/`
Cline	Enable Skills → helix	Workspace link → `.cline/skills/`
OpenCode / Pi	Per tool skill UI	Workspace link → `.agents/skills/`

Workspace link (from project root):

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

Commit .github/skills/ if your team uses Copilot on the same repository.

git clone https://github.com/Thitic9203/helix.git
cd helix
./scripts/setup.sh
git config core.hooksPath scripts/hooks

cd ~/.helix/tc-fe-prep && git pull

Situation	Action
Normal upgrade	`git pull` only
Removed symlinks	`bash ~/.helix/tc-fe-prep/scripts/link-skills.sh`
New skill + team `.github/skills/`	`HELIX_LINK_WORKSPACE=$PWD ~/.helix/tc-fe-prep/scripts/link-skills.sh`
Claude plugin cache stale	Re-run install script

See Troubleshooting if something still fails.