Files
Tabish Bidiwale 9ae6141eb1 feat: Add codex custom slash command support (#120)
* Document current cli specs and archive safety

* feat: add Codex slash command support

Add support for generating and updating Codex prompts in `.codex/prompts/` directory:
- Implement CodexSlashCommandConfigurator for managing openspec-*.md prompts
- Update AI_TOOLS configuration to include Codex as an available option
- Add Codex registration in SlashCommandRegistry
- Update documentation to reflect Codex support
- Add comprehensive test coverage for Codex init and update workflows

* feat: complete Codex slash command support implementation

Add comprehensive Codex slash command support with Claude.md integration,
config-driven command management, and full test coverage. Update documentation
and changelog to reflect changes.

* chore: mark all Codex slash command tasks as completed

All tasks for the Codex slash command support feature have been implemented and tested.

* docs: remove Codex-specific note from README

Remove the Codex-specific installation note as it's no longer needed in the main setup instructions. This information is better suited for tool-specific documentation.
2025-10-09 01:55:47 +11:00

1.9 KiB

1. CLI integration

  • 1.1 Add Codex to the init tool picker with display text that clarifies prompts live in the global .codex/prompts/ directory and implement "already configured" detection by checking for managed Codex prompt files.
  • 1.2 Implement a CodexSlashCommandConfigurator that writes .codex/prompts/openspec-{proposal,apply,archive}.md, ensuring the prompt directory exists and wrapping content in OpenSpec markers. // (No helper command required)
  • 1.3 Register the configurator with the slash-command registry and include Codex in init/update wiring so both commands invoke the new configurator when appropriate.

2. Prompt templates

  • 2.1 Extend the shared slash-command templates (or add a Codex-specific wrapper) to inject numbered placeholders ($1, $2, …) where Codex expects user-supplied arguments.
  • 2.2 Verify generated Markdown stays within Codex's formatting expectations (no front matter, heading-first layout) and matches the problem-analyzer style shown in the reference screenshot.

3. Update support & tests

  • 3.1 Update the openspec update flow to refresh existing Codex prompts without creating new ones when files are missing.
  • 3.2 Add integration coverage that exercises init/update against a temporary global Codex prompts directory by setting CODEX_HOME, asserting marker preservation and idempotent updates.
  • 3.3 Document Codex's global-only discovery and automatic installation in README and CHANGELOG.
  • 3.3 Confirm error handling surfaces clear paths when the CLI cannot write to the Codex prompt directory (permissions, missing home directory, etc.).

4. Documentation

  • 4.1 Document Codex slash-command support in the README and changelog alongside other assistant integrations.
  • 4.2 Add a release note snippet that points Codex users to the generated /openspec-proposal, /openspec-apply, and /openspec-archive commands.