feat(cli): add plx command alias and rebrand as OpenSplx

[appboypov]

Summary

• Adds plx as an alias command for all OpenSpec commands
• Rebrands the fork as OpenSplx with new logo assets
• Both plx and openspec commands work identically

Changes

• New pixel art logos: assets/opensplx_pixel_light.svg, assets/opensplx_pixel_dark.svg
• Updated README with fork notice and Quick Start section
• Added plx bin entry to package.json
• Created bin/plx.js entry point
• Added src/utils/command-name.ts for dynamic command detection
• Updated CLI and completion system to support both command names

Test plan

• plx --version outputs version
• plx --help shows "plx" as command name
• openspec --version still works
• plx completion generate zsh generates correct completions
• Unit tests pass (399/400 - one unrelated environment failure)

[Copilot]

Pull request overview

This PR adds a plx command alias to the OpenSpec CLI and rebrands the fork as OpenSplx. The implementation introduces dynamic command name detection that allows both openspec and plx commands to work identically, with all CLI output, completions, and help text automatically adapting to the command used.

Key Changes:

• Dynamic command name detection via src/utils/command-name.ts that inspects process.argv[1] to determine if invoked as 'plx' or 'openspec'
• Shell completion system updated to generate command-specific completion scripts for both aliases
• New pixel art logo assets for OpenSplx branding with light and dark variants

Reviewed changes

Copilot reviewed 9 out of 12 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/utils/command-name.ts	New utility for detecting command name from invocation path
src/cli/index.ts	Updated to use dynamic command name from detection utility
src/core/completions/types.ts	Added optional commandName parameter to CompletionGenerator interface
src/core/completions/generators/zsh-generator.ts	Updated to generate command-specific completion scripts using provided command name
src/commands/completion.ts	Updated to pass detected command name to generators and show command-specific messages
bin/plx.js	New entry point for plx command alias
package.json	Added plx bin entry alongside existing openspec entry
scripts/postinstall.js	Updated completion install messages to reference both commands
test/core/completions/generators/zsh-generator.test.ts	Updated test expectation to match lowercase command name in generated comments
README.md	Added fork notice, OpenSplx branding, and Quick Start section
assets/opensplx_pixel_light.svg	New light theme pixel art logo
assets/opensplx_pixel_dark.svg	New dark theme pixel art logo

Comments suppressed due to low confidence (2)

src/core/completions/generators/zsh-generator.ts:90

• The new commandName parameter functionality is not covered by tests. The existing tests all use the default 'openspec' command name and never test the 'plx' alias behavior. Add test cases that verify the generator correctly produces completions for 'plx', including checking that function names, comments, and command references all use the provided command name.

  generate(commands: CommandDefinition[], commandName: string = 'openspec'): string {
    const script: string[] = [];

    // Header comment
    script.push(`#compdef ${commandName}`);
    script.push('');
    script.push(`# Zsh completion script for ${commandName} CLI`);
    script.push('# Auto-generated - do not edit manually');
    script.push('');

    // Main completion function
    script.push(`_${commandName}() {`);
    script.push('  local context state line');
    script.push('  typeset -A opt_args');
    script.push('');

    // Generate main command argument specification
    script.push('  local -a commands');
    script.push('  commands=(');
    for (const cmd of commands) {
      const escapedDesc = this.escapeDescription(cmd.description);
      script.push(`    '${cmd.name}:${escapedDesc}'`);
    }
    script.push('  )');
    script.push('');

    // Main _arguments call
    script.push('  _arguments -C \\');
    script.push('    "1: :->command" \\');
    script.push('    "*::arg:->args"');
    script.push('');

    // Command dispatch logic
    script.push('  case $state in');
    script.push('    command)');
    script.push(`      _describe "${commandName} command" commands`);
    script.push('      ;;');
    script.push('    args)');
    script.push('      case $words[1] in');

    // Generate completion for each command
    for (const cmd of commands) {
      script.push(`        ${cmd.name})`);
      script.push(`          _${commandName}_${this.sanitizeFunctionName(cmd.name)}`);
      script.push('          ;;');
    }

    script.push('      esac');
    script.push('      ;;');
    script.push('  esac');
    script.push('}');
    script.push('');

    // Generate individual command completion functions
    for (const cmd of commands) {
      script.push(...this.generateCommandFunction(cmd, commandName));
      script.push('');
    }

    // Add dynamic completion helper functions
    script.push(...this.generateDynamicCompletionHelpers(commandName));

    // Register the completion function
    script.push(`compdef _${commandName} ${commandName}`);
    script.push('');

    return script.join('\n');
  }

  /**
   * Generate a single completion function
   *
   * @param functionName - Name of the completion function
   * @param varName - Name of the local array variable

scripts/postinstall.js:24

• Unused function getCommandName.

function getCommandName() {

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The getCommandName() function is defined but never called in this file. This creates dead code that could confuse future maintainers. Either use this function to pass the command name to the generator on line 91, or remove it if it's not needed in the postinstall context. If the intention is to always use 'openspec' for postinstall, the function should be removed.

Suggested change

	* Detect the command name from the invocation path
	*/
	function getCommandName() {
	const scriptPath = process.argv[1] || '';
	const scriptName = path.basename(scriptPath).replace(/\.js$/, '');
	// Default to 'openspec' for postinstall context
	return scriptName === 'plx' ? 'plx' : 'openspec';
	}
	/**

[appboypov]

Fixed. Removed the unused getCommandName() function. In the postinstall context, the script always runs via npm (not via plx or openspec commands), so command name detection is not applicable here.