Codex Useful Plugins

Small local Codex plugins for safer repository work.

Public repository: https://github.com/lalishka/codex-useful-plugins

This repository contains three lightweight plugins. They are skills-only: no backend, no MCP server, no accounts, no telemetry, and no paid API usage.

Plugins

Plugin	Purpose
project-context-scout	Maps an unfamiliar repository before Codex edits it.
docs-state-sync	Keeps docs/PROJECT_STATE.md, docs/NEXT.md, docs/TESTING.md, and related docs aligned with meaningful changes.
github-publication-readback	Publishes or verifies GitHub repositories with auth, tests, push, metadata, and public readback checks.

Install Locally

Clone this repository, then add its marketplace to Codex:

codex plugin marketplace add .agents/plugins/marketplace.json

Then install the plugins you want from the Codex plugin UI.

Validate

npm test

The test script validates plugin manifests, skill files, marketplace entries, and common packaging mistakes.

Repository Layout

.agents/plugins/marketplace.json
plugins/
  project-context-scout/
  docs-state-sync/
  github-publication-readback/
scripts/validate-repo.mjs
docs/

Scope

These plugins do not install themselves globally. A clone of this repo is just a source bundle until you add its marketplace in Codex.

License

MIT