Win2race — AI skill for Claude Code

Win-to-Race

Win-to-Race is a native macOS app that orchestrates multiple coding CLIs on the same real software task. Each agent gets its own branch, workspace, logs, ADR, runtime report, and feedback record.

Current V1 Scope

• Native SwiftUI macOS app with Simple Mode and Advanced Mode.
• Automatic CLI discovery for Claude, Gemini, Codex, aider/OpenCode-based providers, and prepared frontier-provider slots.
• Actionable Setup overview that tells the user what to install, save, test, or fix next before the app is green.
• File-backed Markdown persistence under ~/Documents/Win2Race/workspace.
• Per-agent workspace, branch naming, runtime logs, generated ADR, and feedback files.
• Runtime registry with CLI/profile health, capabilities, and per-agent command overrides.
• Structured per-run events.jsonl beside session.log for machine-readable lifecycle, stdout, stderr, git, question, error, and heartbeat events.
• Agent profiles for model override, extra CLI arguments, timeout, Git commit identity, and per-agent SSH key preparation.
• Workspace root visibility and safe artifact cleanup for regenerable directories.
• Interactive session handling with live logs and a pending-question state.
• Secure API-key storage through the macOS Keychain, plus per-token test buttons for auth, access, and budget/quota checks.
• Copyable diagnostics for failed setup, provider, runtime, parser, and process errors.
• Markdown task parser for Advanced Mode.

Setup Readiness

The Setup screen is intentionally strict. Win-to-Race only asks for provider tokens needed by installed/configured runtimes. A provider token is not considered green just because it exists in the macOS Keychain. Each visible token must be saved and then tested.

The overview tells the user the next concrete action:

• install a missing CLI
• open the correct provider key page
• paste and save a missing token
• run the token test
• fix ENV syntax
• copy a failed diagnostic message

This avoids the old fa