К основному содержанию
плагин CX Codex

codetruss — плагин для Claude Code: что делает и как установить

Плагин codetruss для Claude Code и Codex задаёт границы файлов агента и проверяет изменения локальными анализаторами, формируя подписанные чеки ревью.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codetruss@awesome-codex-plugins
Открыть на GitHub

Что делает codetruss

Плагин связывает сессию ИИ-агента с утилитой codetruss. Перед внесением правок инструмент определяет разрешённые и запрещённые пути в репозитории, блокируя правки за пределами задачи. После генерации кода запускаются локальные анализаторы и собственные команды проверки проекта на чистом дереве Git.

Внутри работает локальный SAST-движок для JavaScript и TypeScript: поиск внедрения SQL-кода, массового присвоения, пропущенных await перед записью в базу и циклов с проблемой N+1. На каждый прогон утилита выписывает подписанный отчёт, доступный для автономной валидации через codetruss verify.

Плагин не содержит встроенного сканера и требует заранее установленный CodeTruss CLI версии 0.2.35 или новее, а также Node.js от 20.9.

Какие задачи решает

  • ограничить изменения файлов рамками конкретной задачи
  • проверить диффы на утечки секретов до открытия пулл-реквеста
  • выявить грубые дефекты базы данных и типов в коде на JS и TS
  • сохранить криптографически подписанное свидетельство проверки изменений

Примеры запросов агенту

  • Настрой CodeTruss для этого репозитория
  • Запусти проверку текущих изменений через локальный барьер
  • Покажи последний отчёт верификации сессии

Как установить codetruss

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codetruss@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о codetruss

Как установить codetruss в Claude Code?

Сначала добавьте каталог командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем установите пакет вызовом /plugin install codetruss@awesome-codex-plugins.

Что делает codetruss?

Он направляет правки агента через локальные анализаторы, проверяет заданные границы файлов и генерирует подписанный чек с результатами проверки.

Какие требования нужны для работы плагина?

В системе должны быть установлены Git, среда Node.js версии не ниже 20.9 и отдельный бинарник CodeTruss CLI от версии 0.2.35.

Исходный текст

codetruss-plugins · MIT
# CodeTruss agent plugins

CodeTruss is the deterministic first-pass verification gate for AI-written code.
This repository is the open wrapper that puts that gate inside Claude Code and
Codex: a skill that teaches the agent to operate the separately installed
CodeTruss CLI, bind each task to an approved file boundary, run the repository's
own verification commands, and read the signed receipt the CLI writes for every
change. The analysis is deterministic and runs on the developer's machine, the
receipt records exactly what ran and what did not, and anyone can re-verify a
receipt offline. Nothing here calls a model, uploads source, or scores a repo by
vibes.

The wrappers contain no analyzer, no bundled hook, no MCP server, and no upload
path. They invoke the separately installed CLI, keep deterministic analysis
local, and require explicit consent before installation, provider-backed `--llm`
review, authentication, or receipt `sync`.

## Install for Claude Code

Inside a Claude Code session:

```text
/plugin marketplace add DeliriumPulse/codetruss-plugins
/plugin install codetruss@codetruss
```

Or from a shell:

```bash
claude plugin marketplace add DeliriumPulse/codetruss-plugins
claude plugin install codetruss@codetruss
```

Then ask Claude to `Set up CodeTruss for this repository`. The skill proposes an
allow/deny boundary and verification commands, waits for your confirmation, and
runs the CLI's own guided `codetruss setup` with `--hooks claude` so the tested
CLI installer owns hook installation. From then on the gate runs on the agent's
lifecycle events and writes a receipt per session.

The owned marketplace is live now. CodeTruss is not currently listed in
Anthropic's reviewed community catalog or its separately curated official
marketplace.

## Prerequisites

- Git
- Node.js 20.9 or newer
- CodeTruss CLI v0.2.35 or newer from <https://codetruss.com/cli>

Skill instructions in this repository are verified against the shipped CLI
v0.2.35. The skill can explain the official installer when the CLI is missing,
but it must not install software without the developer's confirmation.

## What a receipt looks like

Verbatim excerpt from `codetruss report latest` after a review where the agent
also touched a denied path and committed a live key:

```markdown
# CodeTruss receipt — FAILED

- **Session:** `20260807T051345990Z-4f2f16`
- **Task:** Add a SESSION_TTL constant to src/auth.ts
- **Starting commit:** `14482ad37ea1f3ea5c9547071b58c3cdffb7c0b0`
- **Policy SHA-256:** `d13f4367129bb7683c486d4d4e8e876bc1e9a7f541cd0e539945743b16d95a03`

## Verdict: FAILED

- 1 high/critical security or dependency finding(s) affect changed files
- 1 file(s) changed in denied paths: infra/deploy.sh
- 1 file(s) changed outside approved scope: .codetruss.yml
- sensitive surfaces changed: .codetruss.yml (policy)

## Changed files (3)

| Path | Change | Scope | Sensitive | Lines |
|---|---|---|---|---:|
| `.codetruss.yml` | added | unexpected | policy | +5/−0 |
| `infra/deploy.sh` | added | denied | — | +3/−0 |
| `src/auth.ts` | modified | allowed | — | +1/−0 |

## Introduced or worsened analyzer findings (1)

| Severity | Analyzer | Location | Finding |
|---|---|---|---|
| HIGH | secrets | `infra/deploy.sh:2` | Possible Stripe live secret key committed in deploy.sh |

## Analysis profile

Profile: `local-registry-v2`.

The 13 deterministic registry analyzers ran locally on this machine, plus a local
security pass: the shared SAST engine — the same rules and the same
source-to-sink taint tracking as the hosted audit — over the JavaScript,
TypeScript and TSX in this repository.

### What the local security pass checked

- **SQL injection (CWE-89).** Untrusted input tracked from request sources
  through string building into query execution.
- **Mass assignment (CWE-915).** A raw request body spread into a database
  write, and write helpers whose payload type accepts arbitrary keys.
- **Un-awaited database writes, swallowed errors, coercion-prone `==`
  comparisons, and N+1 queries in loops** — the defect classes coding agents
  most often introduce.

### What did not run

- **The rest of the security rule pack.** Command injection, code injection,
  path traversal, SSRF, open redirect, XSS and insecure deserialization were
  **not** checked here. Those rules run in a hosted scan; absence of a finding
  in those classes means they were not analyzed, not that the code is clean.
- **Non-JavaScript languages.** The local pass covers JavaScript, TypeScript and
  TSX only. Python, Go, Java, C#, PHP, Ruby and Rust in this repository received
  secret scanning and the other registry passes, but no security rule or taint
  analysis.
- **Hosted symbol graph.** No cross-file call or data-flow graph was built, so
  architecture and dead-code conclusions cover only what the local passes can
  see in isolation.
- **Optional LLM review.** No model read this diff. It is opt-in via `--llm` and
  is force-disabled under agent hooks, so a hook receipt is always deterministic
  evidence only.
- **Hosted Health scores.** Not calculated, reported as **N/A**. The scores are
  defined over the graph and the complete SAST pass; a number derived from this
  pass set would overstate what ran.

Local security findings are reported for review and do not fail the verdict on
their own.
```

`codetruss verify latest` re-checks the signature over those bytes and prints
`verified 20260807T051345990Z-4f2f16 (FAILED)`.

## What runs where

Local and deterministic, with no account and no network required:

- the 13 registry analyzers listed in the receipt's analysis profile;
- since CLI v0.2.35, a security pass running the shared SAST engine and its
  source-to-sink taint tracking over the repository's JavaScript, TypeScript and
  TSX: SQL injection, mass assignment, un-awaited database writes, swallowed
  errors, coercion-prone `==`, and N+1 queries in loops;
- scope classification of every changed file against the approved allow/deny
  boundary, including untracked and sensitive-surface detection;
- secret detection on changed files;
- the repository's own verification commands, executed against a fresh
  materialization of the final Git tree;
- receipt signing and offline `codetruss verify`.

Hosted, and only when the developer explicitly asks for it:

- the rest of the security rule pack — command injection, code injection, path
  traversal, SSRF, open redirect, XSS, insecure deserialization — and every
  non-JavaScript language;
- the cross-file symbol graph, which together with the full rule pack backs the
  full-codebase audit and the Health scores;
- receipt `sync` to a CodeTruss account.

A local receipt names its own remaining gaps in its "What did not run" section,
and local security findings are `REVIEW_REQUIRED` at most — they never fail a
verdict on their own. Optional provider-backed `--llm` review is force-disabled
under agent hooks, so a hook receipt is always deterministic evidence only.

Measured behaviour on public repositories is published at
<https://codetruss.com/benchmark>. CLI downloads, checksums, and the SBOM are at
<https://codetruss.com/cli>.

## Codex

```bash
codex plugin marketplace add DeliriumPulse/codetruss-plugins
codex plugin add codetruss@codetruss
```

The owned marketplace is live now. CodeTruss is not currently listed in
OpenAI's public Plugin Directory.

## Agent Skills clients

Install the same canonical skill for both Claude Code and Codex with the public
Agent Skills installer:

```bash
npx --yes skills add DeliriumPulse/codetruss-plugins \
  --skill codetruss --agent claude-code codex -y
```

For an immutable install, pin the most recent published release:

```bash
npx --yes skills add \
  https://github.com/DeliriumPulse/codetruss-plugins/tree/v0.1.5 \
  --skill codetruss --agent claude-code codex -y
```

The skill is indexed at
<https://skills.sh/DeliriumPulse/codetruss-plugins/codetruss>. Review the skill
before use; it can invoke the separately installed CLI with the agent's local
permissions.

## What the skill does

- proposes a narrow repository allow/deny policy and verification commands;
- runs guided `codetruss setup` only after the developer confirms the boundary,
  hook target, and exact verification-command trust;
- installs and diagnoses the existing Claude Code or Codex lifecycle hook;
- reviews working-tree or staged changes and interprets the resulting receipt;
- treats exit codes 1 and 2 as product verdicts with valid evidence, not generic
  shell failures;
- refuses to weaken policy merely to manufacture a green verdict.

The canonical Agent Skills definition is in `skills/codetruss/`. Platform
packages contain byte-identical copies so each marketplace archive is
self-contained.

## Development

```bash
npm test
claude plugin validate . --strict
claude plugin validate ./plugins/codetruss-claude --strict
python3 /path/to/plugin-creator/scripts/validate_plugin.py ./plugins/codetruss
npm run release:verify
```

`npm test` uses only Node.js built-ins and verifies manifests, marketplace
entries, skill parity, and privacy guardrails.
`npm run release:verify` builds the OpenAI and Claude plugin archives twice
from the committed Git tree and proves their bytes are reproducible.

## Security and support

Read [SECURITY.md](SECURITY.md) before reporting a vulnerability. General
wrapper issues belong in this repository; CLI issues belong in the
[CodeTruss CLI tracker](https://github.com/DeliriumPulse/codetruss-cli/issues).
Never attach third-party source, credentials, or unredacted receipts to a public
issue.

## Licensing boundary

The manifests and skill instructions in this repository are MIT licensed. The
separately installed CodeTruss CLI is free to use under the CodeTruss CLI
Proprietary License and CodeTruss Terms of Service. This repository does not
make the CLI open source and does not redistribute its executable bundle.

© CodeTruss · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Безопасность» →
ub-mode unclebob Скилл ub-mode для Claude Code помогает разработчикам структурировать изменения в коде. Он направляет процесс разработки, следуя принципам «Сначала заставь работать, затем сделай правильно, затем следуй практикам». CX Codex +1 930установок methodology-advisor FlorianBruniaux Команда methodology-advisor для Claude Code и Codex изучает кодовую базу и задаёт три вопроса, чтобы подобрать подходящий стек методологий AI-разработки. Запускается вручную, когда нужно выбрать процесс до начала активной работы с агентом. CX Codex +1 ★ 6 529звёзд репо security-guidance официальный Anthropic Плагин security-guidance для Claude Code проверяет генерируемый код тремя слоями: предупреждает при редактировании, анализирует дифф после ответа и проверяет коммиты. ★ 47 914звёзд репо mcp-tunnels официальный Anthropic Плагин mcp-tunnels соединяет Claude с MCP-сервером внутри вашей сети через туннель Anthropic: без входящих портов и публичного доступа. ★ 47 914звёзд репо hookify официальный Anthropic Плагин hookify создаёт хуки и правила для Claude Code через простые Markdown-файлы. Защищает проект от случайных опасных команд и нежелательных правок в коде. ★ 47 914звёзд репо code-modernization официальный Anthropic Плагин code-modernization ведёт перенос легаси-кода по шагам: разбор, план, сборка и доказательство, что новое поведение совпадает со старым. ★ 47 914звёзд репо claude-security официальный Anthropic Плагин claude-security ищет уязвимости в вашем коде прямо в сессии Claude, проверяет каждую находку и по желанию готовит патчи. ★ 47 914звёзд репо google-cloud-developer официальный Google LLC Плагин google-cloud-developer помогает агенту настраивать Google Cloud, выбирать учётные данные и проверять команды gcloud. MCP-сервер подключает актуальную документацию Google. CX Codex ★ 24 522звёзд репо

Из того же набора391

Весь набор →
codex-howto Плагин codex-howto для Claude Code и Codex устанавливает девять скиллов, ведущих задачу от скоупа через тесты и ревью к отчёту с доказательствами. CX Codex ★ 1 596звёзд репо codex-auto-resume Плагин codex-auto-resume для Claude Code и Codex отслеживает лимиты Codex в Windows, ждёт сброса и автоматически возобновляет ту же сессию через codex queue. CX Codex ★ 1 596звёзд репо codex-agents-workflow Плагин codex-agents-workflow для Claude Code помогает собирать и запускать повторно используемые рабочие процессы агентов. Включается для настройки ролей и провайдеров или восстановления запусков. CX Codex ★ 1 596звёзд репо ateam Плагин ateam превращает Codex в команду из шести ролей: исследователь, PM, архитектор, разработчик, QA и ревьюер. Пайплайн настраивается, роли вызываются упоминанием. CX Codex ★ 1 596звёзд репо codebase-recon Плагин codebase-recon изучает историю Git, чтобы показать устройство проекта до чтения кода. Помогает найти часто меняющиеся и проблемные файлы, а также понять распределение знаний в команде. CX Codex ★ 1 596звёзд репо clueless Плагин clueless для Claude Code включает режим, в котором агент отвечает так, будто проверять его работу некому. Сначала он выделяет необратимые шаги, затем предлагает одну проверку. CX Codex ★ 1 596звёзд репо click Плагин click управляет инкрементальным запуском тестов в Claude Code и Codex. Пропускает нетронутые проверки и выдаёт короткие квитанции вместо длинных логов. CX Codex ★ 1 596звёзд репо clean-room Плагин clean-room разделяет анализ разрешённого исходного кода и чистую реализацию. Он пригодится для подготовки поведенческих спецификаций без переноса исходных материалов в код. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой