~ / rigs / WingedGuardian / x4-ai-toolkit

WingedGuardian/x4-ai-toolkit

AI-assisted X4: Foundations modding with Claude Code and Codex; OpenCode support is best effort. Inspect merged game data, validate XML patches, investigate mod conflicts, review your mod list, and build or repair mods with X4-specific know

↗ GitHub ★ 2 NOASSERTION updated today project Claude CodeCodex
stack: Python
share on X
ARCHETYPE
Skill Collector
Ten-plus skills loaded on demand. A procedural-knowledge library.
CONTEXT TAX · EVERY TURN
~9.4k tokens
Heavy · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details
Quality 38/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit WingedGuardian/x4-ai-toolkit/.claude ./rig-x4-ai-toolkit  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/find-session .claude/skills/find-session
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-balance .claude/skills/x4-balance
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-cli-reference .claude/skills/x4-cli-reference
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-debug .claude/skills/x4-debug
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-live .claude/skills/x4-live
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-mod-interaction .claude/skills/x4-mod-interaction
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-mod-release-review .claude/skills/x4-mod-release-review
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-modlist-review .claude/skills/x4-modlist-review
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-probe .claude/skills/x4-probe
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-scaffold .claude/skills/x4-scaffold
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-toolkit-dev .claude/skills/x4-toolkit-dev
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-update-mod .claude/skills/x4-update-mod
$ npx degit WingedGuardian/x4-ai-toolkit/.agents/skills/x4-xml-patching .claude/skills/x4-xml-patching
$ curl -fsSL --create-dirs -o .claude/agents/cross-file-impact.md https://raw.githubusercontent.com/WingedGuardian/x4-ai-toolkit/master/.claude/agents/cross-file-impact.md
$ curl -fsSL --create-dirs -o .claude/agents/mod-research.md https://raw.githubusercontent.com/WingedGuardian/x4-ai-toolkit/master/.claude/agents/mod-research.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/protect-bash.sh\""
          }
        ]
      },
      {
        "matcher": "PowerShell",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/protect-bash.sh\""
          }
        ]
      },
      {
        "matcher": "Edit|Write|NotebookEdit",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/protect-files.sh\""
          },
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/backup-before-edit.sh\""
          }
        ]
      },
      {
        "matcher": "Grep|Glob",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/search-scope.sh\""
          }
        ]
      }
    ]
  }
}

Skills (13)

Subagents (2)

cross-file-impact
model: sonnet
Use BEFORE implementing a multi-file X4 change. Traces ALL files that must change for an intended change (the cross-file dependency fan-out) so nothing is forgotten. The structural complement to x4val
mod-research
model: sonnet
Use BEFORE editing or updating any X4 mod. Researches a mod's Nexus page (description, articles, changelogs, comments, bug reports) and maps the relevant reference\ structure, returning a distilled br

Hooks (11)

eventmatcherruns
PreToolUseBashbash "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-bash.sh"
PreToolUsePowerShellbash "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-bash.sh"
PreToolUseEdit|Write|NotebookEditbash "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-files.sh"
PreToolUseEdit|Write|NotebookEditbash "$CLAUDE_PROJECT_DIR/.claude/hooks/backup-before-edit.sh"
PreToolUseGrep|Globbash "$CLAUDE_PROJECT_DIR/.claude/hooks/search-scope.sh"
PostToolUseEdit|Write|NotebookEditbash "$CLAUDE_PROJECT_DIR/.claude/hooks/x4validate-on-edit.sh"
PostToolUseBash|PowerShell|Edit|Write|NotebookEdit|mcp__.*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/save-sentinel.sh"
SessionStart*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/check-reference-version.sh"
SessionStart*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/session-canary.sh"
SessionStart*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/charter.sh" session-start
UserPromptSubmit*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/charter.sh" prompt

Similar rigs

copied ✓