Skip to content
Get started

CLI reference

User-facing Pentect commands and their purpose.

Launch clients

CommandPurpose
pentect codexLaunch Codex CLI through Pentect
pentect claudeLaunch Claude Code through Pentect
pentect codex appLaunch Codex App for this protected session
pentect claude appLaunch Claude Desktop for this protected session

Client launchers accept --upstream URL for a compatible upstream and --plugins SOURCE for a one-off plugin addition. App launchers also accept --app PATH and --check.

Protect local input and execution

CommandPurpose
pentect mask [TEXT]Mask arguments or UTF-8 stdin
pentect read PATHPrint a masked preview of a file
pentect exec "COMMAND"Resolve known handles locally, run the command, and mask stdout/stderr
pentect view HANDLEShow handle metadata without revealing its value
pentect resolve [PATH...]Resolve known handles from stdin or in selected files
pentect log [--json]Follow local protection events

Use resolve carefully: resolving a file writes plaintext to its destination. Prefer exec when a command can consume a handle directly.

Installation health

CommandPurpose
pentect doctorCheck readiness
pentect doctor --jsonEmit machine-readable diagnostics
pentect doctor --fixOffer safe repairs
pentect update [VERSION]Install a verified GitHub Release binary
pentect update --checkCheck without installing
pentect uninstallRemove the binary while retaining project data
pentect versionPrint the installed version

Plugins

text
pentect plugins new NAME
pentect plugins dev PATH
pentect plugins publish PATH
pentect plugins add SOURCE [--yes]
pentect plugins remove NAME
pentect plugins list [--json]
pentect plugins search [QUERY] [--json]
pentect plugins inspect NAME [--json]
pentect plugins test NAME [--json]
pentect plugins config NAME [KEY=VALUE | --unset KEY]
pentect plugins setup NAME [--yes]
pentect plugins update [NAME] [--yes]

Pentect is open source.