statusline command

statusline prints CC Safety Net’s current state as one line of emoji for Claude Code’s status line, such as 🛡️ CC Safety Net ✅🌳. It requires --claude-code, or its short form -cc. Without the flag, it prints an error, shows help, and exits 1. For a multi-line report that explains each problem, run status instead.

bunx cc-safety-net statusline --claude-code
# -cc is the short form of --claude-code
bunx cc-safety-net statusline -cc

The status line is for Claude Code only. It checks whether the marketplace plugin is enabled, so it does not suit other agents or a manual Claude Code hook.

Set up the Claude Code status line

Add a statusLine entry to ~/.claude/settings.json. Claude Code picks up the change without a restart. Choose the runner that matches your environment:

Bun (recommended)
Claude X
NPM
Pipe with existing command

{
  "statusLine": {
    "type": "command",
    "command": "bunx cc-safety-net statusline --claude-code"
  }
}

{
  "statusLine": {
    "type": "command",
    "command": "BUN_BE_BUN=1 claude x cc-safety-net statusline --claude-code"
  }
}

claude x works only with a native Claude Code installation. If you installed Claude Code through npm, use bunx or npx instead.

{
  "statusLine": {
    "type": "command",
    "command": "npx -y cc-safety-net statusline --claude-code"
  }
}

If you already have a status line command, pipe it into CC Safety Net so both outputs show:

{
  "statusLine": {
    "type": "command",
    "command": "your-existing-command | bunx cc-safety-net statusline --claude-code"
  }
}

statusline indicators

The line shows one level indicator, then any state indicators in this order:

🛡️ CC Safety Net <level><worktree><weakened><degraded>

Indicator	Meaning
`✅`	Effective level is `standard`
`🔒`	Effective level is `strict`
`👁️`	Effective level is `paranoid`
`🔧`	Effective level is `custom`, because the enabled capabilities match no preset or a `destructive_command_protection.overrides` entry changes a rule from its level default
`🌳`	Worktree mode is on
`🔻`	A project `.cc-safety-net/policy.json` relaxes at least one field of your user policy. The line omits it for weakenings that `CC_SAFETY_NET_PROJECT_TIGHTEN_ONLY` ignores
`⚠️`	Part of the configuration failed to load, so it is degraded
`❌`	The `cc-safety-net@cc-marketplace` plugin is not enabled. It replaces every other indicator, so the line reads `🛡️ CC Safety Net ❌`

The level is the effective level after CC Safety Net combines policy.json with the environment. See Environment. 🔻 and ⚠️ do not name the field or file involved. Run status for the details. ❌ reads only enabledPlugins["cc-safety-net@cc-marketplace"] in your Claude Code settings. With a manual Claude Code hook, the line shows ❌ even though protection is active.

statusline piped input

When you pipe input to statusline, it reads stdin. It discards Claude Code’s JSON status payload. It keeps any other piped text and puts it in front of the indicators as <stdin> | <status>.

Get started

Guides

Configuration

Troubleshooting

CLI commands

Rules and protection

Logs and traces

More reference

Concepts

Project

Set up the Claude Code status line

statusline indicators

statusline piped input

​Set up the Claude Code status line

​statusline indicators

​statusline piped input

Set up the Claude Code status line

statusline indicators

statusline piped input