skip to content
github7 stars, opens in a new tab

docsgetting started

Quick start

Install ttheme, load its command and pick a palette. Nothing in your configs changes until you confirm.

On this page
  1. Next

  1. Check Node and zsh.

    ttheme needs Node 22 or newer for npx, and zsh, which macOS ships.

    node --version  # v22 or newer
zsh --version

  2. Run init.

    npx @kecan0406/ttheme@latest init

    It asks which terminals to wire and which palettes to install, lists every file it will change, and writes nothing until you say yes.

  3. Load the command.

    New tabs have it. In the tab you ran init from, start your shell again:

    exec zsh
    exec bash -l
    exec fish

    iTerm2, Konsole, Terminal.app and Contour read their profiles only when they start, so quit and reopen them once.

  4. Pick a palette.

    ttheme

    The tab shows each palette the cursor lands on. enter asks whether it becomes the default for new tabs or stays in this tab, and esc leaves the tab as it was.

Next