# Testrun Hypershift

> Run E2E tests on HyperShift cluster Use when this capability is needed.

- Skill: `tomevault-io/testrun-hypershift` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/testrun-hypershift`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/testrun-hypershift/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/testrun-hypershift

---


# Run Tests on HyperShift

> **Auto-approved**: All test execution on hosted HyperShift clusters is auto-approved.

## Context-Safe Execution (MANDATORY)

**Test output MUST go to files.** Test runs produce hundreds of lines.

```bash
export LOG_DIR=/tmp/kagenti/tdd/${WORKTREE:-$CLUSTER}
mkdir -p $LOG_DIR

# Pattern: redirect test output
command > $LOG_DIR/test-run.log 2>&1; echo "EXIT:$?"
# On failure: Task(subagent_type='Explore') with Grep to find FAILED|ERROR
```

## When to Use

- Running full E2E tests including MLflow, Phoenix, auth
- Validating before merging to main
- Testing OpenShift-specific features

## Run All Tests

```bash
KUBECONFIG=~/clusters/hcp/kagenti-hypershift-custom-$CLUSTER/auth/kubeconfig \
  ./.github/scripts/local-setup/hypershift-full-test.sh $CLUSTER --include-test \
  > $LOG_DIR/test-all.log 2>&1; echo "EXIT:$?"
```

## Run Specific Tests

```bash
KUBECONFIG=~/clusters/hcp/kagenti-hypershift-custom-$CLUSTER/auth/kubeconfig \
  ./.github/scripts/local-setup/hypershift-full-test.sh $CLUSTER \
  --include-test --pytest-filter "test_agent or test_mlflow" \
  > $LOG_DIR/test-filtered.log 2>&1; echo "EXIT:$?"
```

## Run from Worktree

```bash
KUBECONFIG=~/clusters/hcp/kagenti-hypershift-custom-$CLUSTER/auth/kubeconfig \
  .worktrees/$WORKTREE/.github/scripts/local-setup/hypershift-full-test.sh $CLUSTER \
  --include-test --pytest-filter "test_agent"
```

## Test Categories

| Filter | Tests | Notes |
|--------|-------|-------|
| `test_agent` | Agent conversation tests | Needs LLM (OpenAI) |
| `test_mlflow` | MLflow traces, auth | HyperShift only |
| `test_agent or test_mlflow` | Both (recommended) | Traces need fresh agent calls |

## Related Skills

- `test:run-kind` - Run on Kind (faster, no MLflow)
- `test:review` - Review test quality
- `tdd:hypershift` - Full TDD loop on HyperShift
- `hypershift:cluster` - Create cluster if needed

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/kagenti) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->