sentinel config

Initialize and manage Sentinel CLI configuration

2 min read

sentinel config

Manage the Sentinel CLI configuration file. Config is stored at ~/.sentinel/config.json (global) or ./.sentinel/config.json (project-local).

Project-local config takes precedence over global config.

Subcommands

sentinel config init

Initialize a new configuration file.

bash
sentinel config init [options]

Options:

FlagDescription
--provider <provider>LLM provider: anthropic, openai, or custom
--rpc <url>Solana RPC endpoint
--non-interactiveSkip prompts, use defaults

Interactive mode (default):

bash
sentinel config init
# LLM provider (anthropic|openai|custom) [rules]:
# Solana RPC endpoint [https://api.mainnet-beta.solana.com]:

Press Enter to accept defaults. Omitting the provider defaults to rules mode (no LLM, no API key required).

Non-interactive mode:

bash
sentinel config init --non-interactive

With explicit values:

bash
sentinel config init --provider anthropic --rpc https://devnet.helius-rpc.com/?api-key=YOUR_KEY

Output: The resulting config JSON is printed after initialization.


sentinel config show

Display the current configuration.

bash
sentinel config show [--format <format>]
bash
sentinel config show
json
{
  "mode": "full",
  "promptGuard": {
    "mode": "rules",
    "rules": { "rulePacks": ["default"] },
    "enabled": true
  },
  "executionSandbox": {
    "rpcEndpoint": "https://api.mainnet-beta.solana.com",
    "policy": {
      "spendingLimits": { "maxPerTx": 10, "maxDaily": 50, "maxWeekly": 200 }
    },
    "enabled": true
  }
}

sentinel config set

Update a single configuration value using dot notation.

bash
sentinel config set <key> <value>

Examples:

bash
# Change the RPC endpoint
sentinel config set executionSandbox.rpcEndpoint https://my-rpc.helius-rpc.com

# Tighten the per-tx spending limit
sentinel config set executionSandbox.policy.spendingLimits.maxPerTx 5

# Switch prompt guard to LLM mode
sentinel config set promptGuard.mode llm

# Set the risk threshold
sentinel config set executionSandbox.policy.riskThreshold 60

The updated full config is printed after each set call.

Default Configuration

Running sentinel config init --non-interactive produces:

json
{
  "mode": "full",
  "promptGuard": {
    "mode": "rules",
    "rules": {
      "rulePacks": ["default"]
    },
    "enabled": true
  },
  "executionSandbox": {
    "rpcEndpoint": "https://api.mainnet-beta.solana.com",
    "policy": {
      "spendingLimits": {
        "maxPerTx": 10,
        "maxDaily": 50,
        "maxWeekly": 200
      }
    },
    "enabled": true
  }
}

Config File Location

PriorityLocation
1 (highest)./.sentinel/config.json (project-local)
2~/.sentinel/config.json (global)

The CLI checks the project-local path first and falls back to global. This lets you maintain different configurations per project.