Yohaku Codex Plugins

Yohaku is a Codex plugin marketplace for small, focused Codex workflow plugins.

When adding the marketplace in Codex App or CLI, use this repository as the marketplace source:

gaoguobin/yohaku

After Codex loads the marketplace, it appears as Yohaku.

What It Does

Current plugins:

• Goal Shaper: turns rough tasks into verifiable Codex Goal mode packages.
• Seed: turns rough ideas into reviewed specs, decisions, or compact handoff plans, then stops before implementation.

What It Does Not Do

• Yohaku plugins do not run implementation work unless a specific plugin says so.
• Goal Shaper does not run /goal or call Codex runtime goal tools.
• Seed does not write code or start implementation; any Writing Plan is only a reviewed handoff artifact.

Use As A Marketplace Plugin

Goal Shaper and Seed are packaged as Codex plugins in the yohaku marketplace:

plugins/goal-shaper/
plugins/seed/

Normal users should install and manage Yohaku plugins with either the Codex App UI or the CLI. See Install, Update, and Uninstall for the full lifecycle.

In the Codex App, start a new thread after installing. Type / to search enabled skills, @ to choose an installed plugin or bundled capability, or $ to mention a known skill directly, such as $goal-shaper.

For UI walkthroughs with screenshots, see:

• UI guide
• UI 使用指南
• UI ガイド

Command-line install uses <plugin-name>@yohaku:

codex plugin marketplace add gaoguobin/yohaku --json
codex plugin list --marketplace yohaku --available --json
codex plugin add <plugin-name>@yohaku --json

For Goal Shaper:

codex plugin marketplace add gaoguobin/yohaku --json
codex plugin list --marketplace yohaku --available --json
codex plugin add goal-shaper@yohaku --json

For Seed:

codex plugin marketplace add gaoguobin/yohaku --json
codex plugin list --marketplace yohaku --available --json
codex plugin add seed@yohaku --json

Start a new Codex thread after installing or reinstalling the plugin.

Validate

Run the unit tests after changing the validator or its guardrail coverage:

python3 -m unittest discover -s tests

Run the repository validator after changing the skill, plugin metadata, or marketplace metadata:

python3 scripts/validate_goal_shaper.py

When the local system skills are available, also run:

python3 "$HOME/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py" plugins/goal-shaper
python3 "$HOME/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py" plugins/seed
python3 "$HOME/.codex/skills/.system/skill-creator/scripts/quick_validate.py" plugins/goal-shaper/skills/goal-shaper
python3 "$HOME/.codex/skills/.system/skill-creator/scripts/quick_validate.py" plugins/seed/skills/seed

Documentation

• Install
• Update
• Uninstall
• UI guide
• UI 使用指南
• UI ガイド
• Validation
• Scenario tests
• Plugin packaging
• Release checklist

License

MIT. See LICENSE.