aura show

List and inspect configuration entities loaded from disk.

Syntax

aura show                              # Summary of entity counts
aura show <entity>                     # List all entities of that type
aura show <entity> [--filter key=val]  # Filter by YAML key path
aura show <entity> <name>              # Detail view of one entity

Entities

Subcommand Description
agents Agent definitions (model, mode, prompt, tool filters)
modes Mode definitions (tool availability, features)
prompts System prompts
providers Provider configurations
hooks Shell hooks (pre/post tool execution)
features Feature configuration (compaction, thinking, tools, vision, etc.)
plugins Go plugins
skills LLM-invocable skills
tasks Scheduled task definitions

Flags

Flag Short Description
--filter -f Filter by YAML key path (key=value, repeatable, dot notation, wildcards supported)

Plus all global flags.

Filtering

The --filter flag accepts YAML key paths using dot notation for nested fields. Values support * wildcards and are matched case-insensitively.

# Filter agents by mode
aura show agents --filter mode=Edit

# Filter agents by model provider
aura show agents --filter model.provider=anthropic

# Filter providers by type
aura show providers --filter type=ollama

# Filter hooks by event timing
aura show hooks --filter event=post

# Wildcard matching
aura show agents --filter model.name=gpt*
aura show providers --filter url=*garfield*
aura show plugins --filter description=*tool*

# Combine multiple filters (all must match)
aura show agents --filter mode=Edit --filter model.provider=ollama

Key paths follow the YAML structure of the entity. Use aura show <entity> <name> to see the available fields and discover key paths.

Examples

# Show entity counts
aura show

# List all agents
aura show agents

# Detail view of a specific agent
aura show agents High

# List all providers
aura show providers

# List only ollama providers
aura show providers --filter type=ollama

# Show full feature configuration
aura show features

Migration

aura show replaces the following commands:

Old command New command
aura plugins list aura show plugins
aura plugins show <name> aura show plugins <name>
aura skills list aura show skills
aura skills show <name> aura show skills <name>
aura tasks list aura show tasks
aura tasks show <name> aura show tasks <name>

The management operations (add, remove, update, run) remain under their original parent commands (aura plugins, aura skills, aura tasks).


Back to top

Copyright © 2026 idelchi. Distributed under the MIT License.