{"id":50055963,"url":"https://github.com/code-yeongyu/codex-comment-checker","last_synced_at":"2026-05-21T13:14:00.000Z","repository":{"id":358008826,"uuid":"1239427225","full_name":"code-yeongyu/codex-comment-checker","owner":"code-yeongyu","description":"Codex plugin that runs comment-checker automatically after apply_patch edits.","archived":false,"fork":false,"pushed_at":"2026-05-15T08:39:43.000Z","size":45,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-15T09:25:59.580Z","etag":null,"topics":["apply-patch","codex","codex-plugin","comment-checker","hooks","typescript"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/code-yeongyu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-15T04:46:39.000Z","updated_at":"2026-05-15T08:45:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/code-yeongyu/codex-comment-checker","commit_stats":null,"previous_names":["code-yeongyu/codex-comment-checker"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/code-yeongyu/codex-comment-checker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fcodex-comment-checker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fcodex-comment-checker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fcodex-comment-checker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fcodex-comment-checker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/code-yeongyu","download_url":"https://codeload.github.com/code-yeongyu/codex-comment-checker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fcodex-comment-checker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33301809,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-21T12:23:38.849Z","status":"ssl_error","status_checked_at":"2026-05-21T12:22:11.673Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apply-patch","codex","codex-plugin","comment-checker","hooks","typescript"],"created_at":"2026-05-21T13:13:56.970Z","updated_at":"2026-05-21T13:13:59.992Z","avatar_url":"https://github.com/code-yeongyu.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# codex-comment-checker\n\n[![ci](https://github.com/code-yeongyu/codex-comment-checker/actions/workflows/ci.yml/badge.svg)](https://github.com/code-yeongyu/codex-comment-checker/actions/workflows/ci.yml) [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nCodex plugin that runs [`@code-yeongyu/comment-checker`](https://github.com/code-yeongyu/go-claude-code-comment-checker) after successful edit-like `PostToolUse` hook calls.\n\n## Behavior\n\n| Case | Result |\n|------|--------|\n| `apply_patch` succeeds | parses `tool_input.command` and checks added/updated files |\n| `write`, `edit`, `multi_edit`, or `multiedit` succeeds | maps the Codex payload to the native checker hook input |\n| non-edit tool succeeds | ignored |\n| checker exits `2` | returns Codex `PostToolUse` blocking feedback so the model fixes or explains the warning |\n| checker binary missing or unavailable on the current platform | emits no hook output |\n| checker exits unexpectedly | leaves hook output unchanged |\n\nDeletes are ignored because they cannot introduce new comments.\n\n## Codex Plugin\n\nThe plugin ships:\n\n- `.codex-plugin/plugin.json` for Codex plugin discovery.\n- `hooks/hooks.json` for the `PostToolUse` hook.\n- `skills/comment-checker/SKILL.md` with usage guidance.\n\nThe hook command is:\n\n```bash\nnode \"${PLUGIN_ROOT}/dist/cli.js\" hook post-tool-use\n```\n\nNo MCP server or `comment_check` tool is exposed.\n\n## Local Development\n\n```bash\nnpm install\nnpm test\nnpm run typecheck\nnpm run check\nnpm pack --dry-run\n```\n\nSmoke-test the hook:\n\n```bash\nnode dist/cli.js hook post-tool-use \u003c test/fixtures/post-tool-use.json\n```\n\n## Local Codex Installation\n\nFrom the marketplace root containing this plugin:\n\n```bash\ncodex plugin marketplace add /path/to/codex-plugins\nnode /path/to/codex-plugins/scripts/install-local.mjs /path/to/codex-plugins\n```\n\nIf your local Codex build exposes plugin install commands, you can install from the UI or CLI instead. For older local builds, the marketplace installer builds and copies the plugin into `~/.codex/plugins/cache/\u003cmarketplace\u003e/codex-comment-checker/0.1.1`, installs runtime dependencies there, and enables:\n\n```toml\n[features]\nplugins = true\nplugin_hooks = true\n\n[plugins.\"codex-comment-checker@code-yeongyu-codex-plugins\"]\nenabled = true\n```\n\n## Branch Rules and Releases\n\n- `main` is protected by `.github/branch-ruleset.json`.\n- CI runs Node 20 and 22 on Ubuntu, macOS, and Windows.\n- Releases are GitHub Releases tagged as `v\u003csemver\u003e`.\n- Publishing runs from the `publish` workflow after a GitHub Release is published.\n\n## Privacy\n\nThis plugin runs locally. It sends hook input to the optional local `comment-checker` binary when available and does not call a network service by itself.\n\n## License\n\n[MIT](LICENSE).\n\n## Related\n\n- [pi-comment-checker](https://github.com/code-yeongyu/pi-comment-checker) - source extension this Codex plugin ports.\n- [comment-checker](https://github.com/code-yeongyu/go-claude-code-comment-checker) - native checker binary.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-yeongyu%2Fcodex-comment-checker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcode-yeongyu%2Fcodex-comment-checker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-yeongyu%2Fcodex-comment-checker/lists"}