diff --git a/src-tauri/src/bin/rssh/commands/group.rs b/src-tauri/src/bin/rssh/commands/group.rs
index 0f2871d2..8e27a3c8 100644
--- a/src-tauri/src/bin/rssh/commands/group.rs
+++ b/src-tauri/src/bin/rssh/commands/group.rs
@@ -22,10 +22,20 @@ pub fn cmd_list_groups(conn: &CliCtx) -> AppResult<()> {
         return Ok(());
     }
 
-    println!("{:<24} {:<9} ORDER", "NAME", "COLOR");
+    println!("{:<24} {:<9} ORDER WAVES", "NAME", "COLOR");
     println!("{}", "-".repeat(42));
     for group in groups {
-        println!("{:<24} {:<9} {}", group.name, group.color, group.sort_order);
+        println!(
+            "{:<24} {:<9} {} {}",
+            group.name,
+            group.color,
+            group.sort_order,
+            if group.terminal_waves_enabled {
+                "on"
+            } else {
+                "off"
+            }
+        );
     }
     Ok(())
 }
@@ -34,11 +44,13 @@ pub fn cmd_add_group(conn: &CliCtx) -> AppResult<()> {
     let name = prompt("Name: ");
     let color = prompt_default("Color (#RRGGBB)", "#4A6CF7");
     let sort_order = prompt_default("Sort order", "0");
+    let terminal_waves_enabled = confirm("Show group-color terminal waves", false);
     let group = Group {
         id: uuid::Uuid::new_v4().to_string(),
         name,
         color,
         sort_order: parse_sort_order(&sort_order)?,
+        terminal_waves_enabled,
     };
     rssh_lib::db::group::insert(conn, &group)?;
     println!("Group '{}' created.", group.name);
@@ -56,6 +68,10 @@ pub fn cmd_edit_group(conn: &CliCtx, name: &str) -> AppResult<()> {
     updated.color = prompt_default("Color (#RRGGBB)", &current.color);
     let sort_order = prompt_default("Sort order", &current.sort_order.to_string());
     updated.sort_order = parse_sort_order(&sort_order)?;
+    updated.terminal_waves_enabled = confirm(
+        "Show group-color terminal waves",
+        current.terminal_waves_enabled,
+    );
 
     rssh_lib::db::group::update(conn, &updated)?;
     println!("Group '{}' updated.", updated.name);
diff --git a/src-tauri/src/db/group.rs b/src-tauri/src/db/group.rs
index 07e21aec..ea81e7ab 100644
--- a/src-tauri/src/db/group.rs
+++ b/src-tauri/src/db/group.rs
@@ -73,7 +73,7 @@ fn reconcile_sync_filter_for_group_delete(conn: &rusqlite::Connection, id: &str)
 pub fn list(db: &Db) -> AppResult<Vec<Group>> {
     let conn = db.lock()?;
     let mut stmt = conn.prepare(
-        "SELECT id, name, color, sort_order FROM groups ORDER BY sort_order ASC, name ASC",
+        "SELECT id, name, color, sort_order, terminal_waves_enabled FROM groups ORDER BY sort_order ASC, name ASC",
     )?;
     let rows = stmt.query_map([], |row| {
         Ok(Group {
@@ -81,6 +81,7 @@ pub fn list(db: &Db) -> AppResult<Vec<Group>> {
             name: row.get(1)?,
             color: row.get(2)?,
             sort_order: row.get(3)?,
+            terminal_waves_enabled: row.get(4)?,
         })
     })?;
     Ok(rows.collect::<Result<Vec<_>, _>>()?)
@@ -89,7 +90,7 @@ pub fn list(db: &Db) -> AppResult<Vec<Group>> {
 pub fn get(db: &Db, id: &str) -> AppResult<Group> {
     let conn = db.lock()?;
     conn.query_row(
-        "SELECT id, name, color, sort_order FROM groups WHERE id = ?1",
+        "SELECT id, name, color, sort_order, terminal_waves_enabled FROM groups WHERE id = ?1",
         params![id],
         |row| {
             Ok(Group {
@@ -97,6 +98,7 @@ pub fn get(db: &Db, id: &str) -> AppResult<Group> {
                 name: row.get(1)?,
                 color: row.get(2)?,
                 sort_order: row.get(3)?,
+                terminal_waves_enabled: row.get(4)?,
             })
         },
     )
@@ -107,9 +109,9 @@ pub fn insert_tx(conn: &rusqlite::Connection, g: &Group) -> AppResult<()> {
     validate_name(&g.name)?;
     let color = normalize_group_color(&g.color)?;
     conn.execute(
-        "INSERT INTO groups (id, name, color, sort_order) VALUES (?1, ?2, ?3, ?4) \
-         ON CONFLICT(id) DO UPDATE SET name=excluded.name, color=excluded.color, sort_order=excluded.sort_order",
-        params![g.id, g.name, color, g.sort_order],
+        "INSERT INTO groups (id, name, color, sort_order, terminal_waves_enabled) VALUES (?1, ?2, ?3, ?4, ?5) \
+         ON CONFLICT(id) DO UPDATE SET name=excluded.name, color=excluded.color, sort_order=excluded.sort_order, terminal_waves_enabled=excluded.terminal_waves_enabled",
+        params![g.id, g.name, color, g.sort_order, g.terminal_waves_enabled],
     )?;
     Ok(())
 }
@@ -124,8 +126,8 @@ pub fn update(db: &Db, g: &Group) -> AppResult<()> {
     let color = normalize_group_color(&g.color)?;
     let conn = db.lock()?;
     conn.execute(
-        "UPDATE groups SET name=?1, color=?2, sort_order=?3 WHERE id=?4",
-        params![g.name, color, g.sort_order, g.id],
+        "UPDATE groups SET name=?1, color=?2, sort_order=?3, terminal_waves_enabled=?4 WHERE id=?5",
+        params![g.name, color, g.sort_order, g.terminal_waves_enabled, g.id],
     )?;
     Ok(())
 }
@@ -183,6 +185,7 @@ mod tests {
             name: name.into(),
             color: "#FF0000".into(),
             sort_order: 0,
+            terminal_waves_enabled: false,
         }
     }
 
@@ -202,6 +205,24 @@ mod tests {
         }
     }
 
+    #[test]
+    fn group_waves_survive_insert_update_and_upsert() {
+        let db = Db::open_in_memory().unwrap();
+        let mut group = mk_group("prod", "production");
+        group.terminal_waves_enabled = true;
+        insert(&db, &group).unwrap();
+        assert!(get(&db, "prod").unwrap().terminal_waves_enabled);
+        assert!(list(&db).unwrap()[0].terminal_waves_enabled);
+
+        group.terminal_waves_enabled = false;
+        update(&db, &group).unwrap();
+        assert!(!get(&db, "prod").unwrap().terminal_waves_enabled);
+
+        group.terminal_waves_enabled = true;
+        insert(&db, &group).unwrap();
+        assert!(get(&db, "prod").unwrap().terminal_waves_enabled);
+    }
+
     #[test]
     fn insert_then_get_roundtrip() {
         let db = Db::open_in_memory().unwrap();
diff --git a/src-tauri/src/db/schema.rs b/src-tauri/src/db/schema.rs
index d0bad7d3..c0cd54fa 100644
--- a/src-tauri/src/db/schema.rs
+++ b/src-tauri/src/db/schema.rs
@@ -2,7 +2,7 @@ use rusqlite::{params, Connection};
 
 use crate::error::AppResult;
 
-const SCHEMA_VERSION: u32 = 30;
+const SCHEMA_VERSION: u32 = 32;
 
 fn column_exists(conn: &Connection, table: &str, col: &str) -> AppResult<bool> {
     let mut stmt = conn.prepare("SELECT 1 FROM pragma_table_info(?1) WHERE name = ?2")?;
@@ -667,6 +667,31 @@ pub fn migrate(conn: &Connection) -> AppResult<()> {
         )?;
     }
 
+    if version < 31
+        && table_exists(conn, "groups")?
+        && !column_exists(conn, "groups", "terminal_background")?
+    {
+        conn.execute_batch("ALTER TABLE groups ADD COLUMN terminal_background TEXT DEFAULT NULL;")?;
+    }
+
+    if version < 32 && table_exists(conn, "groups")? {
+        // Some development v31 databases already contain the boolean flag.
+        let needs_wave_flag = !column_exists(conn, "groups", "terminal_waves_enabled")?;
+        if needs_wave_flag {
+            conn.execute_batch(
+                "ALTER TABLE groups ADD COLUMN terminal_waves_enabled INTEGER NOT NULL DEFAULT 0;",
+            )?;
+        }
+        if column_exists(conn, "groups", "terminal_background")? {
+            if needs_wave_flag {
+                conn.execute_batch(
+                    "UPDATE groups SET terminal_waves_enabled = (terminal_background IS NOT NULL);",
+                )?;
+            }
+            conn.execute_batch("ALTER TABLE groups DROP COLUMN terminal_background;")?;
+        }
+    }
+
     if version < SCHEMA_VERSION {
         conn.pragma_update(None, "user_version", SCHEMA_VERSION)?;
     }
@@ -676,6 +701,141 @@ pub fn migrate(conn: &Connection) -> AppResult<()> {
 
 #[cfg(test)]
 mod tests {
+    #[test]
+    fn migration_32_preserves_groups_and_defaults_group_waves_to_disabled() {
+        let conn = rusqlite::Connection::open_in_memory().unwrap();
+        conn.execute_batch("CREATE TABLE groups (id TEXT PRIMARY KEY, name TEXT NOT NULL, color TEXT NOT NULL, sort_order INTEGER NOT NULL);
+            INSERT INTO groups VALUES ('prod', 'Production', '#FF0000', 1);
+            PRAGMA user_version = 30;").unwrap();
+        super::migrate(&conn).unwrap();
+        super::migrate(&conn).unwrap();
+        let group: (String, bool) = conn
+            .query_row(
+                "SELECT name, terminal_waves_enabled FROM groups WHERE id = 'prod'",
+                [],
+                |row| Ok((row.get(0)?, row.get(1)?)),
+            )
+            .unwrap();
+        assert_eq!(group, ("Production".into(), false));
+        assert!(conn
+            .execute("UPDATE groups SET terminal_waves_enabled = NULL", [])
+            .is_err());
+        let version: u32 = conn
+            .pragma_query_value(None, "user_version", |row| row.get(0))
+            .unwrap();
+        assert_eq!(version, 32);
+        assert!(!super::column_exists(&conn, "groups", "terminal_background").unwrap());
+    }
+
+    #[test]
+    fn migration_32_converts_legacy_wave_colors_to_flags() {
+        let conn = Connection::open_in_memory().unwrap();
+        conn.execute_batch(
+            "PRAGMA foreign_keys = ON;
+             CREATE TABLE groups (
+                 id TEXT PRIMARY KEY, name TEXT NOT NULL, color TEXT NOT NULL,
+                 sort_order INTEGER NOT NULL, terminal_background TEXT DEFAULT NULL
+             );
+             INSERT INTO groups VALUES
+                 ('off', 'Disabled', '#112233', 1, NULL),
+                 ('on', 'Enabled', '#445566', 2, '#AABBCC');
+             CREATE TABLE profiles (id TEXT PRIMARY KEY, group_id TEXT REFERENCES groups(id));
+             INSERT INTO profiles VALUES ('ssh', 'on');
+             PRAGMA user_version = 31;",
+        )
+        .unwrap();
+
+        migrate(&conn).unwrap();
+        migrate(&conn).unwrap();
+
+        let groups: Vec<(String, String, String, i32, bool)> = conn
+            .prepare("SELECT id, name, color, sort_order, terminal_waves_enabled FROM groups ORDER BY id")
+            .unwrap()
+            .query_map([], |row| Ok((row.get(0)?, row.get(1)?, row.get(2)?, row.get(3)?, row.get(4)?)))
+            .unwrap()
+            .collect::<Result<_, _>>()
+            .unwrap();
+        assert_eq!(
+            groups,
+            vec![
+                ("off".into(), "Disabled".into(), "#112233".into(), 1, false),
+                ("on".into(), "Enabled".into(), "#445566".into(), 2, true),
+            ]
+        );
+        let profile_group: String = conn
+            .query_row(
+                "SELECT group_id FROM profiles WHERE id = 'ssh'",
+                [],
+                |row| row.get(0),
+            )
+            .unwrap();
+        assert_eq!(profile_group, "on");
+        assert!(!column_exists(&conn, "groups", "terminal_background").unwrap());
+        assert!(conn
+            .execute("UPDATE groups SET terminal_waves_enabled = NULL", [])
+            .is_err());
+        conn.execute(
+            "INSERT INTO groups (id, name, color, sort_order) VALUES ('new', 'New', '#778899', 3)",
+            [],
+        )
+        .unwrap();
+        let enabled: bool = conn
+            .query_row(
+                "SELECT terminal_waves_enabled FROM groups WHERE id = 'new'",
+                [],
+                |row| row.get(0),
+            )
+            .unwrap();
+        assert!(!enabled);
+        let version: u32 = conn
+            .pragma_query_value(None, "user_version", |row| row.get(0))
+            .unwrap();
+        assert_eq!(version, 32);
+    }
+
+    #[test]
+    fn migration_32_preserves_existing_wave_flags() {
+        // Also cover a database where both columns are present: the flag wins.
+        for legacy_column in [false, true] {
+            let conn = Connection::open_in_memory().unwrap();
+            conn.execute_batch(
+                "CREATE TABLE groups (
+                     id TEXT PRIMARY KEY, name TEXT NOT NULL, color TEXT NOT NULL,
+                     sort_order INTEGER NOT NULL,
+                     terminal_waves_enabled INTEGER NOT NULL DEFAULT 0
+                 );
+                 INSERT INTO groups VALUES
+                     ('off', 'Disabled', '#112233', 1, 0),
+                     ('on', 'Enabled', '#445566', 2, 1);
+                 PRAGMA user_version = 31;",
+            )
+            .unwrap();
+            if legacy_column {
+                conn.execute_batch(
+                    "ALTER TABLE groups ADD COLUMN terminal_background TEXT DEFAULT NULL;
+                     UPDATE groups SET terminal_background = '#AABBCC' WHERE id = 'off';",
+                )
+                .unwrap();
+            }
+
+            migrate(&conn).unwrap();
+            migrate(&conn).unwrap();
+
+            let flags: Vec<bool> = conn
+                .prepare("SELECT terminal_waves_enabled FROM groups ORDER BY id")
+                .unwrap()
+                .query_map([], |row| row.get(0))
+                .unwrap()
+                .collect::<Result<_, _>>()
+                .unwrap();
+            assert_eq!(flags, vec![false, true]);
+            assert!(!column_exists(&conn, "groups", "terminal_background").unwrap());
+            let version: u32 = conn
+                .pragma_query_value(None, "user_version", |row| row.get(0))
+                .unwrap();
+            assert_eq!(version, 32);
+        }
+    }
     use super::*;
 
     #[test]
diff --git a/src-tauri/src/models.rs b/src-tauri/src/models.rs
index a5b22e1d..c1bb19a5 100644
--- a/src-tauri/src/models.rs
+++ b/src-tauri/src/models.rs
@@ -491,6 +491,9 @@ pub struct Group {
     pub name: String,
     pub color: String,
     pub sort_order: i32,
+    /// Enables terminal waves in the group's color.
+    #[serde(default)]
+    pub terminal_waves_enabled: bool,
 }
 
 // --- Highlight ---
diff --git a/src-tauri/src/sync/config.rs b/src-tauri/src/sync/config.rs
index 3497e44b..d09cebb5 100644
--- a/src-tauri/src/sync/config.rs
+++ b/src-tauri/src/sync/config.rs
@@ -870,6 +870,48 @@ mod tests {
         v
     }
 
+    #[test]
+    fn group_waves_import_defaults_and_boolean_exports() {
+        let (db, ss, dir) = fixture();
+        let legacy = json!({
+            "id": "legacy", "name": "Legacy", "color": "#FF0000", "sort_order": 0
+        });
+        let enabled = json!({
+            "id": "enabled", "name": "Enabled", "color": "#00FF00", "sort_order": 1,
+            "terminal_waves_enabled": true
+        });
+        let disabled = json!({
+            "id": "disabled", "name": "Disabled", "color": "#0000FF", "sort_order": 2,
+            "terminal_waves_enabled": false
+        });
+        merge_import(
+            &db,
+            &ss,
+            dir.path(),
+            &json!({
+                "groups": [legacy.clone(), enabled.clone(), disabled.clone()]
+            }),
+        )
+        .unwrap();
+        let mut expected_legacy = legacy;
+        expected_legacy["terminal_waves_enabled"] = json!(false);
+        let expected = json!([expected_legacy, enabled, disabled]);
+
+        for mode in [
+            ExportMode::LocalBackup,
+            ExportMode::RemotePush(read_sync_prefs(&db).unwrap()),
+        ] {
+            let exported = build_payload(&db, &ss, dir.path(), &mode).unwrap();
+            assert_eq!(exported["groups"], expected);
+            let (restored, restored_ss, restored_dir) = fixture();
+            merge_import(&restored, &restored_ss, restored_dir.path(), &exported).unwrap();
+            assert_eq!(
+                serde_json::to_value(group::list(&restored).unwrap()).unwrap(),
+                expected
+            );
+        }
+    }
+
     #[test]
     fn merge_keeps_local_only_rows() {
         let (db, ss, dir) = fixture();
diff --git a/src/lib/components/EnvironmentWave.svelte b/src/lib/components/EnvironmentWave.svelte
new file mode 100644
index 00000000..b0530e8d
--- /dev/null
+++ b/src/lib/components/EnvironmentWave.svelte
@@ -0,0 +1,34 @@
+<script lang="ts">
+  let { color }: { color: string } = $props();
+  const uid = $props.id();
+  const wavePath = "M100 0 C20 66 20 134 100 200 C180 266 180 334 100 400 C20 466 20 534 100 600 C180 666 180 734 100 800";
+</script>
+
+<div class="environment-wave" style:--group-wave-color={color} aria-hidden="true">
+  {#each [0, 1, 2] as layer}
+    <svg viewBox="0 0 200 800" preserveAspectRatio="none" focusable="false" style:width={`${100 - layer * 2}%`} style:transform={`translateY(${-layer * 9.75}%)`} style:--layer-color={`color-mix(in srgb, var(--group-wave-color), white ${layer * 4}%)`}>
+      <defs>
+        <linearGradient id={`${uid}-${layer}`} x1="0" y1="0" x2="1" y2="0">
+          <stop offset="0%" stop-color="var(--layer-color)" stop-opacity={0.08 + layer * 0.012} />
+          <stop offset="60%" stop-color="var(--layer-color)" stop-opacity={0.16 + layer * 0.015} />
+          <stop offset="100%" stop-color="var(--layer-color)" stop-opacity={0.22 + layer * 0.012} />
+        </linearGradient>
+      </defs>
+      <path d={`${wavePath} H200 V0 Z`} fill={`url(#${uid}-${layer})`} />
+      <path d={wavePath} fill="none" stroke="var(--layer-color)" stroke-width="0.7" stroke-opacity="0.12" />
+    </svg>
+  {/each}
+</div>
+
+<style>
+  .environment-wave {
+    position: absolute;
+    inset: 0 0 0 auto;
+    width: min(23%, 230px);
+    overflow: hidden;
+    pointer-events: none;
+    user-select: none;
+    z-index: 0;
+  }
+  svg { position: absolute; top: 0; right: 0; height: 290%; }
+</style>
diff --git a/src/lib/components/GroupManager.svelte b/src/lib/components/GroupManager.svelte
index 6f401268..7db90221 100644
--- a/src/lib/components/GroupManager.svelte
+++ b/src/lib/components/GroupManager.svelte
@@ -6,6 +6,8 @@
   import { toast } from "../stores/toast.svelte.ts";
   import { t, errMsg } from "../i18n/index.svelte.ts";
   import AppIcon from "./AppIcon.svelte";
+  import EnvironmentWave from "./EnvironmentWave.svelte";
+  import * as theme from "../themes/store.svelte.ts";
 
   let groups = $state<Group[]>([]);
   let adding = $state(false);
@@ -15,6 +17,8 @@
   let formName = $state("");
   let formColor = $state("#4A6CF7");
   let formOrder = $state(0);
+  let formWavesEnabled = $state(false);
+  let previewTheme = $derived(theme.currentTermTheme());
 
   let deleting = $state<string | null>(null);
 
@@ -30,6 +34,7 @@
     formName = "";
     formColor = "#4A6CF7";
     formOrder = 0;
+    formWavesEnabled = false;
   }
 
   function startEdit(g: Group) {
@@ -38,6 +43,7 @@
     formName = g.name;
     formColor = g.color;
     formOrder = g.sort_order;
+    formWavesEnabled = g.terminal_waves_enabled;
   }
 
   function cancelForm() {
@@ -52,6 +58,7 @@
       name: formName.trim(),
       color: formColor,
       sort_order: formOrder,
+      terminal_waves_enabled: formWavesEnabled,
     };
     try {
       await invoke("create_group", { group });
@@ -67,6 +74,7 @@
       name: formName.trim(),
       color: formColor,
       sort_order: formOrder,
+      terminal_waves_enabled: formWavesEnabled,
     };
     try {
       await invoke("update_group", { group });
@@ -86,6 +94,20 @@
   }
 </script>
 
+{#snippet backgroundFields()}
+  <label class="background-toggle">
+    <input type="checkbox" bind:checked={formWavesEnabled} />
+    {t("group.terminal_background")}
+  </label>
+  <p class="background-hint">{t("group.terminal_background_hint")}</p>
+  {#if formWavesEnabled}
+    <div class="terminal-preview" style:background={previewTheme.background} style:color={previewTheme.foreground}>
+      <div class="preview-content">{formName || t("group.name_placeholder")} ~ # <span>{t("group.preview")}</span></div>
+      <EnvironmentWave color={formColor} />
+    </div>
+  {/if}
+{/snippet}
+
 <div class="page">
   <div class="toolbar">
     <button class="btn btn-accent btn-sm" onclick={startAdd}>{t("group.new")}</button>
@@ -97,6 +119,7 @@
       <input type="text" bind:value={formName} placeholder={t("group.name_placeholder")} />
       <label>{t("common.color")}</label>
       <input type="color" bind:value={formColor} />
+      {@render backgroundFields()}
       <label>{t("group.sort_order")}</label>
       <input type="number" bind:value={formOrder} min="0" />
       <div class="form-actions">
@@ -113,6 +136,7 @@
         <input type="text" bind:value={formName} placeholder={t("group.name_placeholder")} />
         <label>{t("common.color")}</label>
         <input type="color" bind:value={formColor} />
+        {@render backgroundFields()}
         <label>{t("group.sort_order")}</label>
         <input type="number" bind:value={formOrder} min="0" />
         <div class="form-actions">
@@ -127,6 +151,9 @@
           <div class="item-text">
             <div class="item-name" title={g.name}>{g.name}</div>
             <div class="item-sub">{t("group.order", { n: g.sort_order })}</div>
+            {#if g.terminal_waves_enabled}
+              <div class="item-sub">{t("group.terminal_background")}: {g.color}</div>
+            {/if}
           </div>
         </div>
         <div class="item-actions">
@@ -160,6 +187,15 @@
 
 <style>
   .page { padding: 24px; }
+  .background-toggle { display: flex; align-items: center; gap: 8px; }
+  .background-hint { color: var(--text-sub); font-size: 12px; margin: 0; }
+  .terminal-preview {
+    position: relative;
+    overflow: hidden;
+    border-radius: 4px;
+    font-family: monospace;
+  }
+  .preview-content { position: relative; z-index: 1; padding: 12px 12px 20px; overflow-wrap: anywhere; }
   .toolbar { display: flex; justify-content: flex-end; margin-bottom: 16px; }
   .item-row { display: flex; justify-content: space-between; align-items: center; gap: 12px; margin-bottom: 16px; }
   .item-info { display: flex; align-items: center; gap: 10px; min-width: 0; }
diff --git a/src/lib/components/TerminalPane.svelte b/src/lib/components/TerminalPane.svelte
index d74c29ee..47fbe2b6 100644
--- a/src/lib/components/TerminalPane.svelte
+++ b/src/lib/components/TerminalPane.svelte
@@ -14,6 +14,8 @@
     import * as syncStatus from "../stores/sync.svelte.ts";
     import * as ai from "../ai/store.svelte.ts";
     import * as theme from "../themes/store.svelte.ts";
+    import {loadTerminalWaveColor, terminalWaveTheme} from "../terminal/environment-wave.ts";
+    import EnvironmentWave from "./EnvironmentWave.svelte";
     import MobileKeybar from "./MobileKeybar.svelte";
     import {registerRsshOscHandlers} from "../osc/handler.ts";
     import {registerClipboardOscHandler} from "../osc/clipboard.ts";
@@ -97,6 +99,14 @@
         onInitialConnectionFailure?: (tabId: string, error: unknown) => boolean;
     } = $props();
 
+    let waveColor = $state<string | null>(null);
+    let baseTermTheme = $state(theme.currentTermTheme());
+
+    $effect(() => {
+        const colors = terminalWaveTheme(baseTermTheme, !!waveColor);
+        if (terminal) terminal.options.theme = colors;
+    });
+
     let containerEl: HTMLDivElement;
     let paneEl: HTMLDivElement; // the .term-outer root — soft-keyboard inset target
     let searchInputEl: HTMLInputElement;
@@ -513,7 +523,7 @@
             // fails. ClipboardItem receives the promise while the user gesture
             // is still active, so the async read does not break clipboard access.
             const pngPromise = app.loadCommandBlockRedaction(true)
-                .then((redaction) => renderBlocksToBlob(term, blocks, {}, fs, redaction))
+                .then((redaction) => renderBlocksToBlob(term, blocks, { theme: baseTermTheme }, fs, redaction))
                 .then((blob) => {
                     if (!blob) throw new Error("render produced no blob");
                     return blob;
@@ -621,6 +631,7 @@
     // The active pane's keyboard toggle, built by setupMobileSoftKeyboard and
     // registered in the activation effect (see below for why not at mount).
     let softKbToggle: (() => void) | null = null;
+    const togglePaneKeyboard = () => softKbToggle?.();
     let mobileTouchScrollCleanup: (() => void) | undefined;
 
     const isLocal = $derived(tabType === "local");
@@ -1504,7 +1515,6 @@
             else helper.setAttribute("style", originalHelperStyle);
             helper.removeEventListener("focus", onFocus);
             helper.removeEventListener("blur", onBlur);
-            if (softKbToggle) app.unregisterSoftKeyboardToggle(softKbToggle);
             softKbToggle = null;
             helper.removeEventListener("input", keepKeyboardHelperInView);
             helper.removeEventListener("keydown", keepKeyboardHelperInView);
@@ -1530,6 +1540,19 @@
     }
 
     onMount(async () => {
+        const focusBeforeInit = document.activeElement;
+        // Transparency is fixed when xterm opens. Capture the accent first;
+        // configuration edits only affect newly opened terminals.
+        let color: string | null = null;
+        try {
+            color = await loadTerminalWaveColor(tabType, meta);
+        } catch (error) {
+            if (!destroyed) console.warn("[terminal] environment group lookup failed:", error);
+        }
+        if (destroyed) return;
+        waveColor = color;
+        baseTermTheme = theme.currentTermTheme();
+
         const IMAGE_STORAGE_LIMIT_MB = app.isMobile ? 32 : 128;
         const IMAGE_PIXEL_LIMIT = app.isMobile ? 4_000_000 : 16_000_000;
 
@@ -1547,7 +1570,8 @@
             // users cannot select at all in mouse mode. Match iTerm2's Option-drag.
             macOptionClickForcesSelection: true,
             */
-            theme: theme.currentTermTheme(),
+            theme: terminalWaveTheme(baseTermTheme, !!waveColor),
+            allowTransparency: !!waveColor,
             // xterm 6 draws its own scrollbar at overviewRuler.width||14 (=14px),
             // out of reach of the global ::-webkit-scrollbar; pin it to the app's 6px.
             overviewRuler: { width: 6 },
@@ -1555,7 +1579,7 @@
         // Listener fires immediately with current theme (already applied above)
         // and on every palette change. Keep the unsubscribe for onDestroy.
         unsubscribeTheme = theme.registerXtermThemeListener((t) => {
-            if (terminal) terminal.options.theme = t;
+            baseTermTheme = t;
         });
         fitAddon = new FitAddon();
         searchAddon = new SearchAddon();
@@ -1651,6 +1675,13 @@
             mobileTouchScrollCleanup = setupTouchScroll(containerEl, terminal);
         }
 
+        // Metadata may resolve after activation; keep any focus the user moved meanwhile.
+        if (app.activeTabId() === tabId && !app.settingsActive()
+            && !showSearch && !app.snippetPickerOpen()
+            && (document.activeElement === focusBeforeInit || document.activeElement === document.body)) {
+            terminal.focus();
+        }
+
         app.registerTerminalControls(tabId, {
             getSelection: () => terminal.getSelection(),
             paste: pasteText,
@@ -1879,6 +1910,7 @@
             // in normal mode. Modified arrows always use CSI with params — SS3 has
             // no param form. That's the protocol, not a design choice.
             app.registerTerminalArrowSender((dir, mod) => {
+                if (!terminal) return;
                 const appMode = terminal.modes.applicationCursorKeysMode;
                 const seq = mod === 0
                     ? (appMode ? `\x1bO${dir}` : `\x1b[${dir}`)
@@ -1888,7 +1920,7 @@
             // Same re-own-on-activation as the writer above: the visible tab's
             // ⌨ button must always control this pane's helper, never a hidden
             // pane that happened to mount later.
-            if (softKbToggle) app.registerSoftKeyboardToggle(softKbToggle);
+            app.registerSoftKeyboardToggle(togglePaneKeyboard);
         }
     });
 
@@ -1932,6 +1964,7 @@
         resizeObs?.disconnect();
         ime229WorkaroundCleanup?.();
         ime229WorkaroundCleanup = undefined;
+        app.unregisterSoftKeyboardToggle(togglePaneKeyboard);
         mobileKeyboardCleanup?.();
         mobileTouchScrollCleanup?.();
         paintScheduler?.dispose();
@@ -1952,7 +1985,7 @@
     });
 </script>
 
-<div class="term-outer" bind:this={paneEl}>
+<div class="term-outer" bind:this={paneEl} style="--term-bg: {baseTermTheme.background}">
     {#if showSearch}
         <div class="search-bar">
             <input
@@ -1991,6 +2024,7 @@
         </div>
     {/if}
     <div class="term-wrap" class:is-mobile={app.isMobile} class:no-block-bar={!app.commandBlockBar()}>
+        {#if waveColor}<EnvironmentWave color={waveColor} />{/if}
         <div class="xterm-host" bind:this={containerEl}></div>
         {#if backlogBytes > BACKLOG_INDICATOR_BYTES}
             <div class="backlog-badge">
@@ -2065,6 +2099,8 @@
 
 <style>
     .term-outer {
+        min-height: 0;
+        background: var(--term-bg);
         display: flex;
         flex-direction: column;
         width: 100%;
@@ -2072,19 +2108,16 @@
     }
 
     .term-wrap {
+        background: var(--term-bg);
         flex: 1;
         min-height: 0;
         position: relative;
     }
 
-    /* xterm.js paints theme.background into the row canvas, but the
-       .xterm-viewport scroll layer keeps its own background. When the
-       user turns off "terminal bg follows theme" and picks a preset
-       whose background differs from --bg, that viewport leaks a
-       frame-coloured ring around the rendered rows. Pin it to --term-bg
-       (kept in sync by themes/store.svelte.ts::writeTermVars). */
+    /* The opaque wrapper preserves the terminal palette. Transparent xterm
+       layers let the right-side accent sit behind glyphs without tinting them. */
     .term-wrap :global(.xterm-viewport) {
-        background-color: var(--term-bg) !important;
+        background-color: transparent !important;
     }
 
     .xterm-host {
diff --git a/src/lib/i18n/locales/en.ts b/src/lib/i18n/locales/en.ts
index d2285010..54ef7ac4 100644
--- a/src/lib/i18n/locales/en.ts
+++ b/src/lib/i18n/locales/en.ts
@@ -1076,6 +1076,9 @@ const en = {
   "forward.local_port_socks5": "Local Port (SOCKS5 proxy)",
   "forward.name_placeholder": "Web Forward",
   // Groups
+  "group.terminal_background": "Terminal wave background",
+  "group.terminal_background_hint": "Blend group-color gradient waves into the right side of SSH, Telnet and serial terminals without taking up space. Changes apply to newly opened terminals.",
+  "group.preview": "Session preview",
   "group.new": "+ New Group",
   "group.empty": "No groups yet",
   "group.name_placeholder": "Group name",
diff --git a/src/lib/i18n/locales/zh.ts b/src/lib/i18n/locales/zh.ts
index 97e4051a..af342a34 100644
--- a/src/lib/i18n/locales/zh.ts
+++ b/src/lib/i18n/locales/zh.ts
@@ -1079,6 +1079,9 @@ const zh: Messages = {
   "forward.local_port_socks5": "本地端口（SOCKS5 代理）",
   "forward.name_placeholder": "Web Forward",
   // 分组
+  "group.terminal_background": "终端波浪背景",
+  "group.terminal_background_hint": "在此分组的 SSH、Telnet 和串口终端右侧显示分组颜色的渐变波浪，不占用终端空间。修改仅对新打开的终端生效。",
+  "group.preview": "会话预览",
   "group.new": "+ 新建分组",
   "group.empty": "暂无分组",
   "group.name_placeholder": "分组名称",
diff --git a/src/lib/stores/app.svelte.test.ts b/src/lib/stores/app.svelte.test.ts
index 26d5dbfd..5baca364 100644
--- a/src/lib/stores/app.svelte.test.ts
+++ b/src/lib/stores/app.svelte.test.ts
@@ -456,11 +456,12 @@ describe("connectTelnetProfile", () => {
       echo_mode: "off",
       backspace: "del",
       login_script: "send super-secret",
-      group_id: null,
+      group_id: "prod",
     });
 
     expect(app.tabs()[1].meta?.echo_mode).toBe("off");
     expect(app.tabs()[1].meta?.profileId).toBe("telnet-1");
+    expect(app.tabs()[1].meta?.groupId).toBe("prod");
     expect(app.tabs()[1].meta?.login_script).toBeUndefined();
   });
 
@@ -482,8 +483,30 @@ describe("connectTelnetProfile", () => {
     app.connectTelnetProfile(legacy);
 
     expect(app.tabs()[1].meta?.echo_mode).toBe("on");
+    expect(app.tabs()[1].meta?.groupId).toBe("");
   });
 });
+
+describe("connectSerialProfile", () => {
+  it.each(["prod", null])("snapshots the connection group %s with the port", async (groupId) => {
+    const app = await loadAppModule();
+    const profile = {
+      id: "serial-1", name: "console", port: "/dev/ttyUSB0",
+      baud_rate: 115200, data_bits: 8, parity: "none", stop_bits: 1,
+      flow_control: "none", xany: false, input_newline: "crlf", output_newline: "raw",
+      local_echo: false, backspace: "del", slow_send: false, input_mode: "text",
+      output_mode: "text", login_script: "", group_id: groupId,
+    };
+
+    app.connectSerialProfile(profile);
+    profile.group_id = "test";
+    profile.port = "/dev/ttyUSB1";
+
+    expect(app.tabs()[1].meta?.groupId).toBe(groupId ?? "");
+    expect(app.tabs()[1].meta?.port).toBe("/dev/ttyUSB0");
+  });
+});
+
 describe("command block split mode", () => {
   it("shares one in-flight load across terminals", async () => {
     let resolveSetting!: (value: unknown) => void;
diff --git a/src/lib/stores/app.svelte.ts b/src/lib/stores/app.svelte.ts
index d3b6be26..e09bf88b 100644
--- a/src/lib/stores/app.svelte.ts
+++ b/src/lib/stores/app.svelte.ts
@@ -76,6 +76,7 @@ export type SettingsPage =
 
 export interface Group {
   id: string; name: string; color: string; sort_order: number;
+  terminal_waves_enabled: boolean;
 }
 export type ConnectionKind = "ssh" | "forward" | "serial" | "telnet";
 export type ConnectionEditorIntent =
@@ -869,6 +870,7 @@ export function connectSerialProfile(sp: SerialProfile) {
     label: sp.name,
     meta: {
       serialProfileId: sp.id,
+      groupId: sp.group_id ?? "",
       port: sp.port,
       baud_rate: String(sp.baud_rate),
       data_bits: String(sp.data_bits),
@@ -898,6 +900,7 @@ export function connectTelnetProfile(tp: TelnetProfile) {
     label: tp.name,
     meta: {
       profileId: tp.id,
+      groupId: tp.group_id ?? "",
       host: tp.host,
       port: String(tp.port),
       input_newline: tp.input_newline,
diff --git a/src/lib/terminal/block-to-image.test.ts b/src/lib/terminal/block-to-image.test.ts
index 7c9216d1..85d790df 100644
--- a/src/lib/terminal/block-to-image.test.ts
+++ b/src/lib/terminal/block-to-image.test.ts
@@ -1,9 +1,10 @@
-import { describe, it, expect } from "vitest";
+import { afterEach, describe, it, expect, vi } from "vitest";
 import {
   paletteToColor,
   resolveFg,
   resolveBg,
   extractImageRows,
+  renderBlocksToBlob,
   redactImageRows,
   type ImageCell,
   type ImageRow,
@@ -302,6 +303,70 @@ describe("extractImageRows", () => {
   });
 });
 
+describe("renderBlocksToBlob theme", () => {
+  afterEach(() => vi.unstubAllGlobals());
+
+  it.each([false, true])("paints opaque defaults, inverse text and underline (override: %s)", async (override) => {
+    const rectangles: { color: string; height: number }[] = [];
+    const text: { color: string; text: string }[] = [];
+    const blob = new Blob(["png"], { type: "image/png" });
+    const context = {
+      fillStyle: "",
+      font: "",
+      textBaseline: "",
+      measureText: () => ({ width: 8 }),
+      scale() {},
+      beginPath() {},
+      moveTo() {},
+      lineTo() {},
+      quadraticCurveTo() {},
+      closePath() {},
+      fill() {},
+      fillRect(_x: number, _y: number, _width: number, height: number) {
+        rectangles.push({ color: this.fillStyle, height });
+      },
+      fillText(value: string) {
+        text.push({ color: this.fillStyle, text: value });
+      },
+    };
+    vi.stubGlobal("document", {
+      fonts: { ready: Promise.resolve() },
+      createElement: () => ({
+        getContext: () => context,
+        toBlob: (callback: BlobCallback) => callback(blob),
+      }),
+    });
+    const sourceTheme = Object.freeze({
+      ...THEME,
+      background: override ? "#11111100" : THEME.background,
+    });
+    const term = fakeTerm([fakeLine([
+      { ch: "N", width: 1 },
+      { ch: "I", width: 1, inverse: true, underline: true },
+      { ch: "C", width: 1, fg: "#ff0000", bg: "#00ff00" },
+    ])]);
+    const sourceOptions = Object.freeze({ theme: sourceTheme });
+    term.options = sourceOptions;
+    Object.freeze(term);
+
+    expect(await renderBlocksToBlob(term, [fakeBlock(1, "#abc", 0, 0)],
+      override ? { theme: THEME } : {})).toBe(blob);
+
+    expect(rectangles[0].color).toBe(THEME.background);
+    expect(rectangles.some(rect => rect.color === THEME.foreground && rect.height > 1)).toBe(true);
+    expect(text).toEqual([
+      { text: "N", color: THEME.foreground },
+      { text: "I", color: THEME.background },
+      { text: "C", color: "rgb(255,0,0)" },
+    ]);
+    expect(rectangles.filter(rect => rect.height === 1)).toEqual([
+      { color: THEME.background, height: 1 },
+    ]);
+    expect(term.options).toBe(sourceOptions);
+    expect(term.options.theme).toBe(sourceTheme);
+  });
+});
+
 /* ───────────────────────── redactImageRows ───────────────────────── */
 
 function imageCells(text: string, fg = "#eeeeee"): ImageCell[] {
diff --git a/src/lib/terminal/block-to-image.ts b/src/lib/terminal/block-to-image.ts
index d70c56ab..3cd9e4a6 100644
--- a/src/lib/terminal/block-to-image.ts
+++ b/src/lib/terminal/block-to-image.ts
@@ -32,6 +32,8 @@ import {
 } from "./command-block-redaction";
 
 export interface RenderOptions {
+  /** 导出使用的主题，默认沿用终端当前主题。 */
+  theme?: ITheme;
   /** 彩色竖线宽度 px。默认 4。 */
   barWidth?: number;
   /** 竖线和文字之间的间距 px。默认 10。 */
@@ -79,7 +81,7 @@ export async function renderBlocksToBlob(
   if (document.fonts?.ready) {
     await document.fonts.ready;
   }
-  const extracted = extractImageRows(term, blocks, foldStore);
+  const extracted = extractImageRows(term, blocks, foldStore, opts.theme);
   const rows = redaction ? redactImageRows(extracted, redaction) : extracted;
   if (rows.length === 0) return null;
   return renderRowsToBlob(rows, term, opts);
@@ -270,12 +272,12 @@ export function extractImageRows(
   term: Terminal,
   blocks: ReadonlyArray<CommandBlock>,
   foldStore?: FoldLookup,
+  theme: ITheme = term.options.theme ?? {},
 ): ImageRow[] {
   const sorted = [...blocks]
     .filter((b) => !b.start.isDisposed)
     .sort((a, b) => a.id - b.id);
   if (sorted.length === 0) return [];
-  const theme: ITheme = term.options.theme ?? {};
   const out: ImageRow[] = [];
   for (const block of sorted) {
     const lines = resolveBlockLines(term, block, foldStore);
@@ -423,7 +425,7 @@ async function renderRowsToBlob(
   const lineHeightMul = term.options.lineHeight ?? 1.0;
   // 1.3 是经验值——xterm 自身行距偏紧，截图里稍宽一点视觉更舒服
   const lineHeight = Math.round(fontSize * Math.max(lineHeightMul, 1.0) * 1.3);
-  const theme: ITheme = term.options.theme ?? {};
+  const theme: ITheme = opts.theme ?? term.options.theme ?? {};
   const bgColor = defaultBg(theme);
 
   const outerPad = opts.outerPad ?? 14;
diff --git a/src/lib/terminal/environment-wave.test.ts b/src/lib/terminal/environment-wave.test.ts
new file mode 100644
index 00000000..120809ee
--- /dev/null
+++ b/src/lib/terminal/environment-wave.test.ts
@@ -0,0 +1,145 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { groupWaveColor, loadTerminalWaveColor, terminalWaveTheme } from "./environment-wave";
+import type { Group } from "../stores/app.svelte";
+import { PALETTES } from "../themes/palettes";
+import { TERM_PRESETS } from "../themes/term-palettes";
+
+const invokeMock = vi.hoisted(() => vi.fn());
+vi.mock("@tauri-apps/api/core", () => ({ invoke: invokeMock }));
+
+const production: Group = {
+  id: "prod", name: "Production", color: "#E05868", sort_order: 0,
+  terminal_waves_enabled: true,
+};
+
+beforeEach(() => { invokeMock.mockReset(); });
+
+describe("group terminal waves", () => {
+  it("preserves each terminal palette's RGB for inverse video and background queries", () => {
+    for (const { term } of [...PALETTES, ...TERM_PRESETS]) {
+      expect(terminalWaveTheme(term, true)).toEqual({ ...term, background: `${term.background}00` });
+      expect(terminalWaveTheme(term, false)).toBe(term);
+      expect(term.background).toMatch(/^#[0-9a-f]{6}$/i);
+    }
+  });
+
+  it.each([
+    ["#abc", "#aabbcc00"],
+    ["#abcd", "#aabbcc00"],
+    ["#FDF6E3", "#FDF6E300"],
+    ["#FDF6E380", "#FDF6E300"],
+    ["rgb(253, 246, 227)", "rgba(253, 246, 227, 0)"],
+    ["rgba(253, 246, 227, 0.5)", "rgba(253, 246, 227, 0)"],
+  ])("retains custom background RGB from %s", (background, expected) => {
+    const original = { background, foreground: "#31355B", red: "#ff0000" };
+    expect(terminalWaveTheme(original, true)).toEqual({ ...original, background: expected });
+    expect(original.background).toBe(background);
+  });
+  it("uses the enabled group's color without a second stored color", () => {
+    expect(groupWaveColor(production)).toBe("#E05868");
+    expect(groupWaveColor({ ...production, color: "#4A6CF7" })).toBe("#4A6CF7");
+  });
+
+  it("omits the decoration when opened with a disabled or missing group", () => {
+    expect(groupWaveColor({ ...production, terminal_waves_enabled: false })).toBeNull();
+    expect(groupWaveColor(null)).toBeNull();
+    expect(groupWaveColor()).toBeNull();
+  });
+
+  it("does not insert malformed colors into SVG styles", () => {
+    for (const color of ["", "red", "#fff", "#123456; color:red"]) {
+      expect(groupWaveColor({ ...production, color })).toBeNull();
+    }
+  });
+});
+
+describe("terminal wave snapshot", () => {
+  it.each(["telnet", "serial"] as const)("keeps the cloned %s target's group when its saved profile is reassigned", async (type) => {
+    const profile = { id: "profile-1", group_id: "prod", host: "prod.example", port: "/dev/ttyUSB0" };
+    const meta = {
+      profileId: profile.id, serialProfileId: profile.id,
+      groupId: profile.group_id, host: profile.host, port: profile.port,
+    };
+    profile.group_id = "test";
+    profile.host = "test.example";
+    profile.port = "/dev/ttyUSB1";
+    const clonedMeta = { ...meta };
+    invokeMock.mockImplementation(async (command: string) => {
+      if (command === "list_telnet_profiles") return [profile];
+      if (command === "get_serial_profile") return profile;
+      if (command === "list_groups") return [production, { ...production, id: "test", color: "#4A6CF7" }];
+      throw new Error(`unexpected command: ${command}`);
+    });
+
+    expect(await loadTerminalWaveColor(type, clonedMeta)).toBe(production.color);
+    expect(clonedMeta.host).toBe("prod.example");
+    expect(clonedMeta.port).toBe("/dev/ttyUSB0");
+    expect(invokeMock.mock.calls).toEqual([["list_groups"]]);
+  });
+
+  it("uses the current saved SSH profile group, matching ssh_connect", async () => {
+    invokeMock.mockImplementation(async (name: string) => {
+      if (name === "get_profile") return { group_id: "prod" };
+      if (name === "list_groups") return [production];
+      throw new Error(`unexpected command: ${name}`);
+    });
+
+    expect(await loadTerminalWaveColor("ssh", { profileId: "ssh-1", groupId: "old" })).toBe(production.color);
+    expect(invokeMock).toHaveBeenCalledWith("get_profile", { id: "ssh-1" });
+  });
+
+  it.each(["telnet", "serial"] as const)("does not reload an ungrouped %s profile", async (type) => {
+    for (const groupId of ["", undefined]) {
+      const meta = { profileId: "profile-1", serialProfileId: "profile-1", ...(groupId === undefined ? {} : { groupId }) };
+      expect(await loadTerminalWaveColor(type, meta)).toBeNull();
+    }
+    expect(invokeMock).not.toHaveBeenCalled();
+  });
+
+  it.each(["local", "docker_exec", "kubectl_exec"] as const)(
+    "does not load decoration settings for %s terminals", async (type) => {
+      const color = await loadTerminalWaveColor(type, { profileId: "unused" });
+      expect(color).toBeNull();
+      expect(terminalWaveTheme(PALETTES[0].term, !!color)).toBe(PALETTES[0].term);
+      expect(invokeMock).not.toHaveBeenCalled();
+    },
+  );
+
+  it("does not load groups without a saved profile", async () => {
+    expect(await loadTerminalWaveColor("ssh", {})).toBeNull();
+    expect(invokeMock).not.toHaveBeenCalled();
+  });
+
+  it.each([false, true])("keeps absent or disabled groups opaque (enabled=%s)", async (enabled) => {
+    invokeMock.mockImplementation(async (command: string) => {
+      if (command === "get_profile") return { group_id: enabled ? "missing" : "prod" };
+      if (command === "list_groups") return [{ ...production, terminal_waves_enabled: enabled }];
+      throw new Error(`unexpected command: ${command}`);
+    });
+
+    const color = await loadTerminalWaveColor("ssh", { profileId: "ssh-1" });
+    const original = PALETTES[0].term;
+    expect(color).toBeNull();
+    expect(terminalWaveTheme(original, !!color)).toBe(original);
+  });
+
+  it("keeps a loaded color stable while new terminals get the edited group color", async () => {
+    const group = { ...production };
+    invokeMock.mockImplementation(async (command: string) => {
+      if (command === "get_profile") return { group_id: "prod" };
+      if (command === "list_groups") return [group];
+      throw new Error(`unexpected command: ${command}`);
+    });
+
+    const existingColor = await loadTerminalWaveColor("ssh", { profileId: "ssh-1" });
+    group.color = "#4A6CF7";
+    const newColor = await loadTerminalWaveColor("ssh", { profileId: "ssh-1" });
+
+    expect(existingColor).toBe("#E05868");
+    expect(newColor).toBe("#4A6CF7");
+    invokeMock.mockClear();
+    for (const { term } of PALETTES) terminalWaveTheme(term, !!existingColor);
+    expect(existingColor).toBe("#E05868");
+    expect(invokeMock).not.toHaveBeenCalled();
+  });
+});
diff --git a/src/lib/terminal/environment-wave.ts b/src/lib/terminal/environment-wave.ts
new file mode 100644
index 00000000..6f8f7f70
--- /dev/null
+++ b/src/lib/terminal/environment-wave.ts
@@ -0,0 +1,51 @@
+import { invoke } from "@tauri-apps/api/core";
+import type { Group, TerminalTabType } from "../stores/app.svelte.ts";
+import type { PaletteTerm } from "../themes/palettes.ts";
+
+export function groupWaveColor(group?: Group | null): string | null {
+  if (!group?.terminal_waves_enabled || !/^#[0-9a-f]{6}$/i.test(group.color)) return null;
+  return group.color;
+}
+
+/** Read once before creating xterm; existing terminals keep this color. */
+export async function loadTerminalWaveColor(type: TerminalTabType, meta: Record<string, string>): Promise<string | null> {
+  if (type !== "ssh" && type !== "telnet" && type !== "serial") return null;
+  // Telnet/serial connect from tab metadata, including when cloned. SSH resolves
+  // its saved profile again on connect, so its group must use the same source.
+  let groupId = meta.groupId;
+  if (type === "ssh") {
+    if (!meta.profileId) return null;
+    const profile = await invoke<{ group_id: string | null }>("get_profile", { id: meta.profileId });
+    groupId = profile.group_id ?? "";
+  }
+  if (!groupId) return null;
+  const groups = await invoke<Group[]>("list_groups");
+  return groupWaveColor(groups.find(group => group.id === groupId));
+}
+
+function transparentColor(value: string): string | null {
+  const color = value.trim();
+  if (/^#(?:[\da-f]{3,4}|[\da-f]{6}|[\da-f]{8})$/i.test(color)) {
+    const rgb = color.length <= 5
+      ? [...color.slice(1, 4)].map(channel => channel.repeat(2)).join("")
+      : color.slice(1, 7);
+    return `#${rgb}00`;
+  }
+  const rgb = color.match(/^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})(?:\s*,\s*[\d.]+)?\s*\)$/i);
+  return rgb ? `rgba(${rgb[1]}, ${rgb[2]}, ${rgb[3]}, 0)` : null;
+}
+
+/** Keep the background RGB: xterm also uses it for inverse video and OSC 11. */
+export function terminalWaveTheme(theme: PaletteTerm, enabled: boolean): PaletteTerm {
+  if (!enabled) return theme;
+  let background = transparentColor(theme.background);
+  if (!background && typeof document !== "undefined") {
+    // Normalize custom CSS colors without rasterizing transparent pixels, which lose RGB.
+    const context = document.createElement("canvas").getContext("2d");
+    if (context) {
+      context.fillStyle = theme.background;
+      background = transparentColor(context.fillStyle);
+    }
+  }
+  return { ...theme, background: background ?? theme.background };
+}