Skip to content

Feature Request: Provide an openspec diff command to show differences between a spec and its modified version. #427

Description

@soc221b

Provide an openspec diff command or a similar feature to show differences between a spec and its modified version.

Currently, we can manually copy /openspec/changes/*/specs/A.md and paste it into /openspec/specs/A/spec.md to compare it with the existing spec.

It would be very useful to have a built-in diff feature to automatically highlight these differences.

Thanks for this powerful tool! ❤️

Activity

  1. self-assigned this
    on Jan 2, 2026
  2. TabishB commented on Jan 2, 2026

    @TabishB
    Contributor

    @soc221b We had this in a very early version, but removed since the diff wasn't very readable inside of the terminal.

    We're currently planning to update the workflow a bit since agents usually struggle to produce and archive the spec deltas currently. We'll revisit this as part of that.

  3. jakubtusan-mcf commented on Jun 13, 2026

    @jakubtusan-mcf

    Hello, is there any update on this topic? What is the recommended way to generate diff?

  4. soc221b commented on Jun 13, 2026

    @soc221b
    Author
  5. yshavit commented on Aug 10, 2026

    @yshavit

    I created a TUI tool to do this. Still pretty early, but I used it to build it! https://github.com/yshavit/opsxexplorer

    My workflow is pretty simple, because I've only used OpenSpec on my personal projects so far: so, single-dev, linear history, etc. I can't make any guarantees as to how well this will look with more complex scenarios, and in particular, it's not at all integrated with OpenSpec's beta store feature.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions