Skip to content

Fix: Windows "Open with" dialog when running superpowers-codex #243

@sean3808

Description

@sean3808

Problem

On Windows, running the command shown in the Superpowers instructions:

~/.codex/superpowers/.codex/superpowers-codex bootstrap

opens the "Open with" dialog instead of executing, because the file has no
extension and Windows does not know how to run it.

What I changed

  1. Run the script with Node directly (works immediately):
node $HOME/.codex/superpowers/.codex/superpowers-codex bootstrap
  1. Make a global wrapper so superpowers-codex works like a normal command:
    Create %USERPROFILE%\.local\bin\superpowers-codex.cmd:
@echo off
setlocal
node "%USERPROFILE%\.codex\superpowers\.codex\superpowers-codex" %*

Add %USERPROFILE%\.local\bin to the User PATH.

  1. Update the instructions to avoid the raw path in future sessions:
  • C:\Users\USER\.codex\AGENTS.md: replace
    ~/.codex/superpowers/.codex/superpowers-codex bootstrap
    with
    node $HOME/.codex/superpowers/.codex/superpowers-codex bootstrap
  • C:\Users\USER\.codex\superpowers\.codex\superpowers-bootstrap.md:
    replace all ~/.codex/superpowers/.codex/superpowers-codex
    with superpowers-codex
  1. Start a fresh Codex session (not just /new) so the updated instructions
    are reloaded.

Result

No more "Open with" dialog. Skill loading commands run normally on Windows.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingcodexIssues related to OpenAI Codex supportdocumentationImprovements or additions to documentationwindows

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions