openspec

name	openspec
description	Manage OpenSpec change lifecycle and project specs via CLI. Use when user needs to create/archive changes, check artifact status, validate proposals, or browse specs.
source_version	1.0.0
source_cli_hash	9c6172a4
generated_at	2026-04-06T08:22:31.209231+00:00

openspec (via mcp2cli)

Manage OpenSpec change lifecycle — create, track, validate, and archive spec changes.

Shortcuts

No shortcuts configured. Use: mcp2cli openspec <group> <cmd>

Commands

project

Command	Description	Example	Ref
mcp2cli openspec project init	Initialize OpenSpec in your project	mcp2cli openspec project init	ref
mcp2cli openspec project update	Update OpenSpec instruction files	mcp2cli openspec project update	ref
mcp2cli openspec project refresh-cache	Force refresh the cached directory listing	mcp2cli openspec project refresh-cache	ref

change

Command	Description	Example	Ref
mcp2cli openspec change create	Create a new change directory	mcp2cli openspec change create --name add-dark-mode --description "Add dark mode support"	ref
mcp2cli openspec change status	Display artifact completion status	mcp2cli openspec change status --change-name add-dark-mode	ref
mcp2cli openspec change instructions	Output enriched instructions for an artifact	mcp2cli openspec change instructions --artifact design.md --change-name add-dark-mode	ref
mcp2cli openspec change archive	Archive a completed change and update main specs	mcp2cli openspec change archive --change-name add-dark-mode	ref

content

Command	Description	Example	Ref
mcp2cli openspec content list	List changes or specs	mcp2cli openspec content list mcp2cli openspec content list --specs	ref
mcp2cli openspec content show	Show details of a change or spec	mcp2cli openspec content show --item-name add-dark-mode	ref
mcp2cli openspec content read-file	Read any OpenSpec artifact file directly	mcp2cli openspec content read-file --name add-dark-mode --file-type design.md	ref
mcp2cli openspec content validate	Validate a change proposal or spec	mcp2cli openspec content validate --item-name add-dark-mode	ref

Discover Parameters

Append --help to any command for full parameter list:

mcp2cli openspec change create --help

Note: Use Ref links in the Commands table above to view detailed parameter reference and more examples.

User Notes

MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in ~/.agents/mcp2cli/servers.yaml - edit there to take effect.