BeClaude

claudemd-cli

New
1knpmGeneralMIT

Standalone CLI for §10-V banned-vocab + transcript scanning. Companion to the claudemd Claude Code plugin (github.com/sdsrss/claudemd) for use in git pre-commit hooks, GitHub Actions, and other agents.

First seen 5/22/2026

Summary

claudemd-cli is a standalone command-line tool that scans transcripts and files for banned vocabulary, enforcing style guidelines defined in §10 of the claudemd plugin.

  • It integrates seamlessly into git pre-commit hooks, GitHub Actions, and CI/CD pipelines to catch disallowed terms before code is committed or shared, ensuring consistent language across your projects.

Install & Usage

1
Create the agents directory
mkdir -p .claude/agents
2
Save the agent file

Add the configuration to .claude/agents/claudemd-cli.md

3
Invoke with @agent-name
@claudemd-cli

Use Cases

Run banned-vocab checks on staged files before committing to prevent policy violations.
Scan Claude Code transcripts for disallowed terms to audit agent interactions.
Integrate into GitHub Actions to automatically lint pull requests for banned vocabulary.
Use as a pre-commit hook to block commits containing flagged terms in any text file.
Batch-scan multiple files or directories for compliance with custom banned-word lists.
Combine with other linters in a CI pipeline to enforce writing style across a team.

Usage Examples

1

/claudemd-cli scan --path src/ --banned-vocab .claudedict.json

2

Check staged files for banned vocabulary: /claudemd-cli scan --git-staged

3

Scan a transcript file for disallowed terms: /claudemd-cli scan --file transcript.md --banned-vocab .claudedict.json

View source on GitHub
agentpluginlintclaudeclaude-codebanned-vocabcommit-hooktranscript-audit

Security Audits

LicensePassSourceWarnRepositoryPass

Frequently Asked Questions

What is claudemd-cli?

claudemd-cli is a standalone command-line tool that scans transcripts and files for banned vocabulary, enforcing style guidelines defined in §10 of the claudemd plugin. It integrates seamlessly into git pre-commit hooks, GitHub Actions, and CI/CD pipelines to catch disallowed terms before code is committed or shared, ensuring consistent language across your projects.

How to install claudemd-cli?

To install claudemd-cli: create the agents directory (mkdir -p .claude/agents), then add the config to .claude/agents/claudemd-cli.md. Finally, @claudemd-cli in Claude Code.

What is claudemd-cli best for?

claudemd-cli is a agent categorized under General. It is designed for: agent, plugin, lint, claude, claude-code, banned-vocab, commit-hook, transcript-audit.

What can I use claudemd-cli for?

claudemd-cli is useful for: Run banned-vocab checks on staged files before committing to prevent policy violations.; Scan Claude Code transcripts for disallowed terms to audit agent interactions.; Integrate into GitHub Actions to automatically lint pull requests for banned vocabulary.; Use as a pre-commit hook to block commits containing flagged terms in any text file.; Batch-scan multiple files or directories for compliance with custom banned-word lists.; Combine with other linters in a CI pipeline to enforce writing style across a team..