Output & Errors

Output Formats

The --format flag controls how data is rendered:

daysurface config show                    # table (default)
daysurface --format json config show      # machine-readable JSON
daysurface --format plain config show     # simple key: value lines

Table (default)

Rich formatted tables with colors and borders. Best for interactive use.

JSON

Machine-readable output, useful for piping into other tools:

daysurface --format json config show | jq '.llm_config'

Plain

Simple key: value lines with no formatting. Good for scripting.

Error Handling

By default, errors show a concise message. Use --debug for full tracebacks with local variables:

daysurface --debug config get nonexistent.key

Dry Run

Preview what a command would do without executing it:

daysurface --dry-run greet Alice
# [DRY RUN] Would greet Alice

Useful for verifying destructive operations before running them for real.

Verbosity

Control how much output you see:

daysurface --verbose greet Alice    # extra details
daysurface --quiet greet Alice      # minimal output