How to use

aish + themes, day-to-day

aish v0.2 caches themes locally and renders deterministically. Every command below is idempotent.

List available themes

$ aish theme list
* default
  monokai
  nord-powerline

The * marks the active theme. Available themes are read from the index at theme-atoms.com/themes/index.json.

Switch theme

$ aish theme set nord-powerline
theme: active = nord-powerline

aish fetches https://theme-atoms.com/themes/nord-powerline.toml, validates against theme-v1.json, caches under ~/.cache/aish/themes/, and applies. Persistent across sessions.

Show the active theme

$ aish theme show
nord-powerline (1.0.0) — Nord palette, powerline separator

Reset to default

$ aish theme set default

Use a custom URL (private/staging)

$ aish theme set --url https://example.com/my-team-theme.toml

Any URL that returns a v1 theme TOML works. The schema is the contract.

Offline mode

If aish can't reach the network, the cached version of the active theme is used. Switching to a never-cached theme while offline errors clearly.

Wrote your own?

Propose it on the builder or file a theme request.