Command-line reference

Reference

Command-line reference

Look up Red's editor, validation, runtime asset, Agent, session, plugin, language, and keyboard commands.

Open the editor

CommandPurpose
red [FILES...]Open zero or more files
red -r PATH [FILES...]Set the workspace root before opening files
red -c TOML [FILES...]Apply a repeatable inline configuration override
red --versionPrint the installed version
red --helpPrint the generated command reference

Check the installation and configuration

CommandPurpose
red --self-checkValidate the bundled runtime and plugins
red --check-configValidate the effective user configuration
red --agent-checkReport Codex prerequisites without installing anything
red --agent-check --strictExit nonzero when Agent editing isn't ready
red keysShow the keyboard protocol and decoded key events

Inspect and eject runtime assets

CommandPurpose
red --runtime-filesList visible plugins and themes with their sources
red --eject ASSETCopy a bundled plugin or theme into the configuration directory
red --eject-force ASSETReplace an existing user copy

Manage sessions

CommandPurpose
red --detach[=NAME] [FILES...]Start a detachable owner and attach this terminal
red --attach NAMEAttach to a local live session
red --stop NAMEStop a local live session
red --resumeRestore the latest crash-recovery snapshot

Manage packages and languages

red plugin catalog
red plugin install [OWNER/REPOSITORY]
red plugin install --path DIRECTORY
red plugin install --catalog ID
red plugin list
red plugin update ID
red plugin update --all
red plugin disable ID
red plugin enable ID
red plugin remove ID [--purge]

red language trust LANGUAGE_OR_PATH
red language untrust LANGUAGE_OR_PATH
red language check-indent FIXTURES.json