On this page
Reference for the c permission command group — subcommands, flags, arguments, and usage details for the permission group in the c CLI.
#c permission
add, remove, and list permission rules across Claude profiles
#permission add
Add a permission rule to a profile's settings.json. Takes a category (allow, deny, or ask) and a rule string such as Bash or Read(//home/**). Writes the rule into the specified category array. Use --profile to target a single profile or --all-profiles to apply the rule across every registered profile. Skips duplicates if the rule already exists in the category.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--profile | str | target a specific profile by name (mutually exclusive with --all-profiles) | |||
--all-profiles | bool | apply the operation to every registered profile at once |
#Arguments
| Name | Required | Description |
|---|---|---|
category | yes | permission category to add the rule to: allow, deny, or ask |
rule | yes | permission rule string to add (e.g. Bash, Read(//home/**), Edit) |
#permission remove
Remove a permission rule from a profile's settings.json. Takes a category (allow, deny, or ask) and the exact rule string to delete. The rule is removed from the specified category array and the file is saved. Use --profile to target a single profile or --all-profiles to remove the rule from every registered profile. Reports whether the rule was found.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--profile | str | target a specific profile by name (mutually exclusive with --all-profiles) | |||
--all-profiles | bool | apply the operation to every registered profile at once |
#Arguments
| Name | Required | Description |
|---|---|---|
category | yes | permission category to remove the rule from: allow, deny, or ask |
rule | yes | exact permission rule string to remove (must match an existing entry) |
#permission list
List permission rules from a profile's settings.json. Displays rules in grouped, flat, or JSON format controlled by --format. Use --category to filter output to a single category (allow, deny, or ask). Use --profile to inspect a single profile or --all-profiles to show rules from every registered profile, with each profile's rules displayed under a header.
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--format | str | output format: grouped (indented tree), flat (tsv), or json | |||
--category | str | restrict output to a single permission category (allow, deny, or ask) | |||
--profile | str | target a specific profile by name (mutually exclusive with --all-profiles) | |||
--all-profiles | bool | apply the operation to every registered profile at once |