CLI reference

Every culp command, what it touches, and which ones make a network call.

Commands

Command	What it does
`culp login`	Authorizes this machine through your browser. 180 days, no refresh token.
`culp logout`	Revokes this device. `--local-only` forgets the credential without telling the server.
`culp setup`	Installs the Claude Code plugin and points it at the right marketplace, verifying each step.
`culp update`	Synchronizes the whole installation: the CLI wheel and the plugin bundle.
`culp status`	Whether this device is active, inactive, revoked or logged out, and what plan it is on.
`culp doctor`	Every check at once, with the value each one found.
`culp version`	The installed version and the cached latest one. No network call.
`culp motd`	The operator's message of the day, from cache unless it is stale.
`culp session-notice`	Everything a session start needs, in one process. Run by the plugin, not by hand.
`culp decode`	The decode hook. Run by the plugin, not by hand.
`culp mcp`	The local MCP server that serves the `patch` tool. Started by Claude Code.

Add --json before any command for machine-readable output, and --no-update-check to skip the version check for that invocation.

login, logout, setup, update, status, doctor, decode, and the refresh half of motd. Everything else answers from disk.

culp version never makes a request: it reads the cached manifest, which is why it is safe to call from a hook.

Variable	Effect
`CULP_HOME`	Where all state lives. Default `~/.culp`.
`CULP_API_URL`	The API base URL.
`CULP_REQUEST_TIMEOUT`	Request timeout in seconds. Default 15.
`CULP_UPDATE_CHECK_INTERVAL`	Seconds between update checks. Default 900.
`CULP_DISABLE_UPDATE_CHECK`	Set to `1` to never check for updates.
`CULP_MOTD_INTERVAL`	Seconds between message-of-the-day refreshes. Default 1800.
`CULP_DISABLE_MOTD`	Set to `1` to never show the message of the day.
`CULP_DISABLE_UPDATE_NOTICE`	Set to `1` to never show the update notice.
`CULP_PLAN_CONTEXT`	Set to `0` to stop the session hook resolving the plan.