Paths: File paths are relative to skills repo root. Locate this SKILL.md directory and go up one level for repo root.

Hex-Line Uninstaller

Type: L3 Worker Category: 0XX Shared

Removes Claude-side hex-line integration surfaces. This worker is standalone-capable but also supports managed ln-010 family transport.

MANDATORY READ: Load references/coordinator_summary_contract.md, references/environment_worker_runtime_contract.md, and references/worker_runtime_contract.md

This worker cleans Claude-side state directly from config files and CLI state. Missing MCP connectivity is not a blocker; continue with local cleanup and verification wherever possible.

Input / Output

Transport inputs:

• standalone: omit runId and summaryArtifactPath
• managed: pass both runId and summaryArtifactPath

Runtime

Runtime family: environment-worker-runtime

Phase profile:

1. PHASE_0_CONFIG
2. PHASE_1_RESOLVE_CLAUDE_STATE
3. PHASE_2_REMOVE_HEXLINE_REGISTRATION
4. PHASE_3_REMOVE_HEXLINE_ARTIFACTS
5. PHASE_4_VERIFY_CLEANUP
6. PHASE_5_WRITE_SUMMARY
7. PHASE_6_SELF_CHECK

Runtime rules:

• emit summary_kind=env-cleanup
• standalone runs generate their own run_id and write the default worker-family artifact path
• managed runs require both runId and summaryArtifactPath and must write the summary to the exact provided path
• always write the validated summary artifact before terminal outcome

Output Contract

Always build a structured env-cleanup summary envelope per:

• references/coordinator_summary_contract.md
• references/environment_worker_runtime_contract.md

Payload fields:

• mcp_removed
• permissions_cleaned
• hooks_removed
• output_style_removed
• verification
• status

What It Removes

Workflow

Phase 1: Resolve Claude State

1. Read ~/.claude/settings.json if present
2. Read ~/.claude/settings.local.json if present
3. Detect:

• hex-line MCP registration in user scope
• permissions.allow entries for mcp__hex-line__*
• hook entries whose command points to the installed hex-line hook
• outputStyle = "hex-line"
• installed style file and hook directory

1. Record exactly which owned surfaces exist before mutating anything

Phase 2: Remove Hex-Line Registration

1. If user-scope hex-line registration exists, run:

claude mcp remove -s user hex-line

1. If registration is already absent, report already removed
2. Do not uninstall the npm package here. This worker owns Claude-side integration surfaces only

Phase 3: Remove Hex-Line Artifacts

1. Update Claude settings surfaces:

• remove permissions.allow entries for mcp__hex-line__*
• remove hook entries whose command contains the active hex-line hook path
• remove empty hook event arrays and remove hooks only when empty
• clear outputStyle only when it is exactly "hex-line"

1. Delete ~/.claude/output-styles/hex-line.md if present
2. Delete ~/.claude/hex-line/hook.mjs if present
3. Delete ~/.claude/hex-line/ only when it is empty after file removal

Rules:

• preserve all non-hex-line settings
• never claim cache cleanup unless a concrete cache deletion step exists
• do not touch unrelated MCP registrations or permission entries

Phase 4: Verify Cleanup

Confirm:

• no user-scope hex-line MCP registration remains
• no permissions.allow entry targets mcp__hex-line__*
• no hex-line hook entry remains in managed Claude settings files
• outputStyle is not "hex-line"
• ~/.claude/output-styles/hex-line.md does not exist
• ~/.claude/hex-line/hook.mjs does not exist

Notes

• This worker removes Claude-side hex-line integration only
• It does not remove the npm package itself
• It is safe to run multiple times

Definition of Done

• [ ] Claude user-scope hex-line MCP registration removed or confirmed absent
• [ ] permissions.allow no longer contains mcp__hex-line__*
• [ ] No hex-line hook entries remain in managed Claude settings files
• [ ] outputStyle: "hex-line" cleared where owned
• [ ] Installed style and hook artifacts removed
• [ ] Structured summary returned
• [ ] Summary artifact written to the managed or standalone runtime path

Version: 1.0.0 Last Updated: 2026-03-27