yaaa docs · Settings

Settings

Spending limits for your agent, shopping preferences for recommendations, and product images in the terminal.

Spending limits

yaaa config limits

Example

┌─ your limits ─────────────┐
│ per purchase     $500.00  │
│ monthly          $1000.00 │
│ used this month  $103.43  │
└───────────────────────────┘

Change themyaaa config limits --per-purchase 200 --monthly 600

What your agent may spend: no single purchase over the per-purchase limit, and no more than the monthly limit in total. They start at $500 and $1,000. Your agent asks you before changing them. You can also change them on the web desk.

Shopping preferences

yaaa config prefs set size.shoes 10

yaaa config prefs set budget.shoes 150

yaaa config prefs set prefer-brands "Allbirds, Veja"

Your agent reads these when it recommends things. Keys: size.<category>, budget.<category>, prefer-brands, avoid-brands, and ships-to. Your agent may offer to save one it learns (“save size 10 for shoes?”); it only does if you say yes.

yaaa config prefs shows them.
yaaa config prefs unset size.shoes removes one; yaaa config prefs clear, all of them.
They stay on this computer.

Product images

yaaa config images auto

auto shows product pictures in terminals that can display them: iTerm2, WezTerm, Kitty, Ghostty, and Warp.
on shows them where that isn’t detected, such as VS Code’s terminal with terminal.integrated.enableImages turned on.
off hides them, including in macOS notifications.

Pictures never appear in --json output, so your agent never sees them. YAAA_IMAGES=0 or 1 overrides the setting.