tg-list-config-items

List all configuration items stored in the TrustGraph configuration service.

Synopsis 

tg-list-config-items [OPTIONS]

Description

The tg-list-config-items command retrieves and displays a list of all configuration items currently stored in the TrustGraph configuration service. This provides an overview of available configuration keys that can be retrieved or modified.

Configuration items include:

  • Flow definitions
  • Prompt templates
  • Token cost configurations
  • Service-specific settings
  • Custom application configurations

Options

Option Description Default
-u, --url URL TrustGraph API URL http://localhost:8088/
--format FORMAT Output format: table, json, list table
--filter PATTERN Filter items by pattern (regex) None
--category CATEGORY Filter by category: flows, prompts, costs, settings All
-h, --help Show help message -

Output Formats

Table Format (Default)

Displays configuration items in a formatted table:

$ tg-list-config-items

+---------------------------+----------+----------------------------------------+
| Key                       | Category | Description                            |
+---------------------------+----------+----------------------------------------+
| flows.default             | flows    | Default processing flow configuration  |
| flows.production          | flows    | Production flow configuration          |
| prompts.system            | prompts  | System prompt template                 |
| prompts.graph-rag         | prompts  | Graph RAG prompt template             |
| token-costs.gpt-4         | costs    | GPT-4 token pricing                  |
| token-costs.claude-3      | costs    | Claude 3 token pricing                |
| settings.max-tokens       | settings | Maximum tokens per request            |
| settings.temperature      | settings | Default temperature setting           |
+---------------------------+----------+----------------------------------------+

List Format

Simple list of configuration keys:

$ tg-list-config-items --format list

flows.default
flows.production
prompts.system
prompts.graph-rag
token-costs.gpt-4
token-costs.claude-3
settings.max-tokens
settings.temperature

JSON Format

Complete JSON response with metadata:

$ tg-list-config-items --format json

{
  "config_items": [
    {
      "key": "flows.default",
      "category": "flows",
      "description": "Default processing flow configuration",
      "modified": "2024-01-15T10:30:00Z",
      "version": 3
    },
    {
      "key": "prompts.system",
      "category": "prompts",
      "description": "System prompt template",
      "modified": "2024-01-10T14:20:00Z",
      "version": 1
    }
  ],
  "total": 8
}

Examples

Basic Usage 

# List all configuration items
tg-list-config-items

# List in simple format
tg-list-config-items --format list

Filtering 

# Filter by pattern
tg-list-config-items --filter "flows.*"

# Filter by category
tg-list-config-items --category prompts

# Complex regex filter
tg-list-config-items --filter "^(flows|prompts)\..*"

Export and Processing 

# Export to file
tg-list-config-items --format json > config-items.json

# Get just the keys
tg-list-config-items --format list > config-keys.txt

# Count items by category
tg-list-config-items --format json | jq '.config_items | group_by(.category) | map({category: .[0].category, count: length})'

Integration with Other Commands 

# List all items, then get details for each
for key in $(tg-list-config-items --format list); do
  echo "=== $key ==="
  tg-get-config-item -k "$key"
done

# Backup all configuration items
tg-list-config-items --format list | while read key; do
  tg-get-config-item -k "$key" --format json > "backup-$key.json"
done

Configuration Categories

Flows

Flow-related configurations:

  • flows.<flow-id> - Individual flow definitions
  • flow-classes.<class-name> - Flow class templates

Prompts

AI prompt templates:

  • prompts.system - System-wide prompts
  • prompts.<service> - Service-specific prompts

Token Costs

Model pricing configurations:

  • token-costs.<model> - Per-model token costs

Settings

General system settings:

  • settings.<parameter> - Various system parameters

Custom

User-defined configurations:

  • custom.<namespace>.<key> - Application-specific settings

Filtering Patterns

The --filter option accepts regular expressions:

# All flow configurations
tg-list-config-items --filter "^flows\."

# Items containing 'rag'
tg-list-config-items --filter ".*rag.*"

# Exclude test items
tg-list-config-items --filter "^(?!.*test).*"

Environment Variables

Variable Description Default
TRUSTGRAPH_URL Default API URL http://localhost:8088/

Exit Codes

Code Description
0 Success
1 Error (connection error, service error, etc.)

Error Handling

Common errors and solutions:

Connection Refused 

Error: Unable to connect to configuration service

Solution: Verify TrustGraph is running and the URL is correct.

Empty Results 

No configuration items found

Solution: Check filter pattern or verify configuration service has data.

Performance Considerations

  • The command retrieves all configuration keys in a single request
  • For large deployments with many configurations, consider using filters
  • Results are cached briefly to improve performance for sequential operations

Troubleshooting

No Items Listed

If no configuration items appear:

  1. Verify the configuration service is running
  2. Check that configurations have been initialized
  3. Ensure proper permissions to access configuration

Filter Not Working

If filtering returns unexpected results:

  1. Test the regex pattern separately
  2. Use simpler patterns first
  3. Check for special character escaping

See Also