background tint by default

Author: RoryQ

README.md

@@ -1,35 +1,54 @@
 # Synesthesia
-### Sense your projects as iTerm2 tab colours
+### Sense your projects as terminal colours
 
-Synesthesia updates your iTerm2 tab colours depending on the go module name in your directory ancestry.
+Synesthesia updates your terminal tab and background colours depending on the go module name in your directory ancestry.
 
-Supports tinting the background with `--background-tint` and worktrees by default
+- **iTerm2**: Automatically updates the tab colour.
+- **Ghostty & Others**: Lightly tints the terminal background (enabled by default).
+
+If you use git worktrees (or jj workspaces), then each copy of the same project will have a different but consistent colour.
 
 # Installation
 ### 1. Install from source using golang 1.25
 
-```
+```bash
 go install github.com/roryq/synesthesia@latest
 ```
 
-### 2. Then configure a hook for your shell.
-### fish
+### 2. Configure a hook for your shell
+
+#### fish
 Add the following line to your `~/.config/fish/config.fish`:
 ```fish
-synesthesia hook fish --background-tint | source
+synesthesia hook fish | source
 ```
 
-### zsh
-Add the following line to your `~/.zshrc`
+#### zsh
+Add the following line to your `~/.zshrc`:
 ```zsh
-eval "$(synesthesia hook zsh --background-tint)"
+eval "$(synesthesia hook zsh)"
 ```
 
 # Usage
-Navigate between your directories as usual. When you have multiple tabs open for different go projects, 
-a consistent random colour will be chosen for any tabs with the same go module name.
+Navigate between your directories as usual. When you have multiple tabs open for different projects, 
+a consistent random colour will be chosen for any tabs with the same project name.
 
-If you use git worktrees (or jj workspaces), then each copy of the same project will have a different but consistent colour.
+### Sense Custom Text
+You can sense a colour for any custom string (useful for agent names or specific project labels):
+```bash
+synesthesia sense "my-project-label"
+```
+
+### Background Tinting
+Background tinting is enabled by default. To disable it, use the `--no-background-tint` flag:
+```bash
+synesthesia --no-background-tint
+```
+
+To generate a hook with tinting disabled:
+```bash
+synesthesia hook zsh --no-background-tint
+```
 
 ![](demo.gif)
 

main.go

@@ -25,7 +25,7 @@ var cli struct {
 	Sense struct {
 		Text string `arg help:"Custom text to sense a color from."`
 	} `cmd help:"Sense a color from custom text."`
-	BackgroundTint bool `help:"Enable background tinting for Ghostty and other terminals."`
+	BackgroundTint bool `default:"true" negatable:"" help:"Enable or disable background tinting for Ghostty and other terminals."`
 }
 
 func main() {
@@ -34,7 +34,7 @@ func main() {
 		kong.Description("Change iTerm2 tab colour based on go module name or custom text."),
 	)
 
-	switch c := ktx.Command(); c {
+	switch ktx.Command() {
 	case "hook <shell>":
 		echoHook(cli.Hook.Shell, cli.BackgroundTint)
 	case "sense <text>":
@@ -174,7 +174,7 @@ func echoHook(shell string, enableTint bool) {
 		bytes, _ := hooks.ReadFile(fmt.Sprintf("hooks/hook.%s", s))
 		script := string(bytes)
 		if !enableTint {
-			script = strings.ReplaceAll(script, " --background-tint", "")
+			script = strings.ReplaceAll(script, "--background-tint", "--no-background-tint")
 		}
 		fmt.Print(script)
 	default: