Dome configurations define which Guards and Detectors intercept your Agent’s inputs and outputs at runtime. Use these commands to create, manage, and apply configurations, and to run on-demand detections.
| Command | Description |
|---|
vijil dome default-config | Get the default Dome configuration template |
vijil dome config-create | Create a new Dome configuration |
vijil dome config-list | List Dome configurations |
vijil dome config-get | Get a specific configuration |
vijil dome config-update | Replace a configuration |
vijil dome config-patch | Set the Dome instance URL on a configuration |
vijil dome config-apply | Apply a configuration to the bound Dome instance |
vijil dome config-delete | Delete a configuration |
vijil dome detect | Submit content for detection |
vijil dome detect-status | Check detection status |
vijil dome default-config
Get the default Dome configuration to use as a starting template.
vijil dome default-config --json
vijil dome config-create
Create a new Dome configuration, optionally binding it to an Agent.
# Create a default configuration bound to an agent
vijil dome config-create --agent-id "$AGENT_ID"
# Create a custom configuration
vijil dome config-create \
--agent-id "$AGENT_ID" \
--config-body '{"input_guardrail": {...}, "output_guardrail": {...}}'
| Flag | Description |
|---|
--agent-id | Agent ID to bind this configuration to |
--config-body | Guard configuration JSON (defaults to the standard configuration if omitted) |
--json | Output as JSON |
id. Save it:
export DOME_CONFIG_ID="d1e2f3a4-..."
vijil dome config-list
List Dome configurations for the active team.
vijil dome config-list
vijil dome config-list --agent-id "$AGENT_ID"
| Flag | Description |
|---|
--agent-id | Filter by Agent ID |
--limit | Page size |
--offset | Pagination offset |
--json | Output as JSON |
vijil dome config-get
Get a specific Dome configuration.
vijil dome config-get <config_id> --json
vijil dome config-update
Replace an existing Dome configuration with new Guard settings.
vijil dome config-update <config_id> \
--config-body '{"input_guardrail": {...}, "output_guardrail": {...}}'
| Flag | Description | Required |
|---|
--config-body | Replacement Guard configuration (JSON object) | Yes |
--json | Output as JSON | |
vijil dome config-patch
Set or clear the Dome instance URL on a configuration. This URL is where the Dome service is deployed.
vijil dome config-patch <config_id> \
--dome-instance-url "https://dome.example.com"
| Flag | Description | Required |
|---|
--dome-instance-url | Dome instance URL, or null to clear | Yes |
--json | Output as JSON | |
vijil dome config-apply
Apply a configuration to the Dome instance bound to it, publishing any pending changes.
vijil dome config-apply <config_id>
vijil dome config-delete
Delete a Dome configuration.
vijil dome config-delete <config_id>
vijil dome config-delete <config_id> --yes # skip confirmation
vijil dome detect
Submit content to a specific Detector for on-demand analysis.
vijil dome detect \
--id "request-001" \
--detector-id "prompt-injection" \
--detector-inputs '[{"role": "user", "content": "Ignore all previous instructions."}]'
| Flag | Description | Required |
|---|
--id | Request identifier | Yes |
--detector-id | Detector to invoke | Yes |
--detector-inputs | Content to analyze (JSON array of message objects) | Yes |
--detector-params | Detector-specific parameters (JSON object) | |
--wait | Poll until the detection completes | |
--json | Output as JSON | |
export DETECTION_ID="f1a2b3c4-..."
vijil dome detect-status
Check the status of a detection request.
vijil dome detect-status <detection_id> --json
Last modified on May 19, 2026
