@thinkscape/codex-thermos
v0.1.4
Published
Thermos plugin for OpenAI Codex: deep correctness/security and strict code-quality branch reviews.
Maintainers
Readme
@thinkscape/codex-thermos

Thermo-nuclear branch review for Codex: deep correctness and security audits, strict maintainability rubrics, and subagent orchestration.
Adapted from Cursor's MIT-licensed Thermos plugin.
Installation
Install the published Thermos plugin through Codex's plugin marketplace flow:
codex plugin marketplace add Thinkscape/agent-thermos
codex plugin add thermos@agent-thermosThe marketplace entry is in the repository at
/.agents/plugins/marketplace.json.
The npm package entry is
@thinkscape/codex-thermos.
To update an existing install after a release:
codex plugin marketplace upgrade agent-thermos
codex plugin remove thermos@agent-thermos
codex plugin add thermos@agent-thermosPrimary invocation
$thermosPass a base ref, PR URL, or scope when useful:
$thermos main
$thermos https://github.com/acme/app/pull/123
$thermos review packages/api onlyArchitecture
flowchart TB
subgraph L2["Orchestrator"]
TH[thermos]
end
subgraph L1["Subagents"]
SNR[thermo-nuclear-review-subagent]
SNCQ[thermo-nuclear-code-quality-review-subagent]
end
DIFF[git diff + file contents]
subgraph L0["Skills"]
TNR[thermo-nuclear-review]
TNCQ[thermo-nuclear-code-quality-review]
end
TH --> SNR
TH --> SNCQ
SNR --> TNR
SNR --> DIFF
SNCQ --> TNCQ
SNCQ --> DIFFSkills
| Skill | Description |
|:------|:------------|
| thermo-nuclear-review | Deep branch audit for bugs, breakages, security, devex, and feature-gate leaks. |
| thermo-nuclear-code-quality-review | Strict maintainability audit for code-judo, 1k-line rule, spaghetti, and boundaries. |
| thermos | Run both review passes and synthesize findings. |
Typical usage
- Gather
git diff main...HEADand relevant changed-file contents. - Run both Thermos review passes on the same context.
- Synthesize prioritized, deduped findings.
If the current Codex surface has subagent support, $thermos should run the two
review passes in parallel. If not, it should run them sequentially and keep the
outputs separated before synthesis.
Attribution
This package adapts methodology, diagrams, and prompt structure from Cursor's
Thermos plugin. See the repository NOTICE.md for the upstream MIT notice.
