actions-marketplace-validations/rich-codex

Create rich code images for your docs

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Maintainedlast commit Apr 22, 2025
License
MIT

Pinned Snippet

workflow.ymlSHA-pinned
uses: actions-marketplace-validations/ewels_rich-codex@80de9de011c994f32274bb4cffee140567621d8e # no releases — HEAD as of 2026-07-10

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
search_includeGlob patterns to files in which to search for rich-codex commentsno
search_excludeGlob patterns to exclude from search for rich-codex commentsno
no_searchSet to 'true' to disable searching for rich-codex commentsno
commandSpecify a command to run to capture outputno
timeoutMaximum run time for command (seconds)no
working_dirWorking directory to run command in (relative to root of project)no
before_commandSetup commands to run before running main output commandno
after_commandSetup commands to run after running main output commandno
snippetLiteral code snippet to renderno
snippet_syntaxLanguage to use for snippet sytax highlightingno
img_pathsPath to image filenames if using 'command' or 'snippet'no
clean_img_pathsRemove any matching files that are not generatedno
rc_configsPaths to YAML config filesno
fake_commandPretend command to show in the screenshot promptno
hide_commandHide the terminal prompt with the command at the top of the outputno
title_commandUse the command as the terminal title if not set explicitlyno
headShow only the first N lines of outputno
tailShow only the last N lines of outputno
trim_afterDon't print any more lines after this string is foundno
truncated_textText to show when '--head' or '--tail' truncate contentno
skip_git_checksSkip safety checks for git reposno
min_pct_diffMinimum file percentage change required to update imageno
skip_change_regexSkip image update if file changes match regexno
terminal_widthWidth of the terminalno
terminal_min_widthMinimum width of the terminal (use trimming)no
notrimDisable automatic trimming of terminal widthno
terminal_themeColour themeno
snippet_themeSnippet Pygments themeno
use_ptyUse a pseudo-terminal for commands (may capture coloured output)no
log_verbosePrint verbose output to the console.no
commit_changesAutomatically commit changes to the repositoryno
error_changesExit with an error if changes are found (Ignored if 'commit_changes' is true)notrue
use_uvIf true, use uv to manage python and install dependencies.nofalse
skip_python_setupIf true, skip Python setup (or skip uv setup if `use_uv` is true). Only use this if you already set up Python in a previous step, e.g. to install additional dependencies. When combined with `use_uv`, this assumes you already ran the `astral-sh/setup-uv` action.nofalse
python_verisonWhich version of Python to use when setting up Python or uv.no3

no outputs