Skip to content

Conversation

@TabishB
Copy link
Contributor

@TabishB TabishB commented Sep 9, 2025

Summary

  • Removes the redundant openspec diff command that duplicated functionality available in openspec show
  • Eliminates ~227 lines of code and the jest-diff dependency
  • Simplifies the CLI interface and reduces maintenance burden

Changes

  • Removed: /src/core/diff.ts - The entire diff command implementation
  • Removed: /openspec/specs/cli-diff/spec.md - The diff command specification
  • Removed: jest-diff dependency from package.json
  • Updated: CLI registration to remove diff command
  • Updated: Documentation to remove diff command references

Migration Guide

Users currently using openspec diff should transition to:

# View change proposal
openspec show <change-name>

# View only deltas
openspec show <change-name> --json --deltas-only

# Use git for file comparisons
git diff openspec/specs openspec/changes/<change-name>/specs

Test Plan

  • All existing tests pass
  • Build completes successfully
  • CLI help no longer shows diff command
  • Show command provides adequate replacement functionality

🤖 Generated with Claude Code

The diff command added unnecessary complexity and duplicated functionality
already available through the show command. Users can now use:
- `openspec show <change>` for structured change viewing
- `openspec show <change> --json --deltas-only` for delta-only views
- Standard git diff or other tools for file comparisons

This change:
- Removes ~227 lines of code and the jest-diff dependency
- Simplifies the CLI interface
- Reduces maintenance burden
- Aligns with verb-first command structure
@TabishB TabishB merged commit 3cef6f0 into main Sep 9, 2025
4 checks passed
drvova pushed a commit to drvova/VovaSpec that referenced this pull request Oct 13, 2025
Remove diff command in favor of show command
Kh05ifr4nD pushed a commit to Kh05ifr4nD/sorapec that referenced this pull request Jan 6, 2026
Remove diff command in favor of show command
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants