start working on #29816

src/vs/platform/terminal/common/terminal.ts

@@ -64,6 +64,9 @@ export const enum TerminalSettingId {
 	DetectLocale = 'terminal.integrated.detectLocale',
 	DefaultLocation = 'terminal.integrated.defaultLocation',
 	GpuAcceleration = 'terminal.integrated.gpuAcceleration',
+	TerminalTitleSeparator = 'terminal.integrated.spacer',
+	TerminalTitle = 'terminal.integrated.title',
+	TerminalDescription = 'terminal.integrated.description',
 	RightClickBehavior = 'terminal.integrated.rightClickBehavior',
 	Cwd = 'terminal.integrated.cwd',
 	ConfirmOnExit = 'terminal.integrated.confirmOnExit',

src/vs/workbench/contrib/terminal/browser/terminal.ts

@@ -563,6 +563,9 @@ export interface ITerminalInstance {
 
 	readonly navigationMode: INavigationMode | undefined;
 
+	description: string | undefined;
+	name: string | undefined;
+
 	/**
 	 * Shows the environment information hover if the widget exists.
 	 */

src/vs/workbench/contrib/terminal/browser/terminalEditorInput.ts

@@ -222,7 +222,7 @@ export class TerminalEditorInput extends EditorInput {
 	}
 
 	public override getDescription(): string | undefined {
-		return this._terminalInstance?.shellLaunchConfig.description;
+		return this._terminalInstance?.description || this._terminalInstance?.shellLaunchConfig.description;
 	}
 
 	public override toUntyped(): IUntypedEditorInput {

src/vs/workbench/contrib/terminal/browser/terminalInstance.ts

@@ -163,6 +163,8 @@ export class TerminalInstance extends Disposable implements ITerminalInstance {
 
 	readonly statusList: ITerminalStatusList;
 	disableLayout: boolean = false;
+	description: string | undefined = undefined;
+	name: string | undefined = undefined;
 	target?: TerminalLocation;
 	get instanceId(): number { return this._instanceId; }
 	get resource(): URI { return this._resource; }
@@ -1750,6 +1752,7 @@ export class TerminalInstance extends Disposable implements ITerminalInstance {
 						title = title.substring(0, firstSpaceIndex);
 					}
 				}
+				this.name = title;
 				break;
 			case TitleEventSource.Api:
 				// If the title has not been set by the API or the rename command, unregister the handler that

src/vs/workbench/contrib/terminal/browser/terminalService.ts

@@ -23,7 +23,7 @@ import { ILabelService } from 'vs/platform/label/common/label';
 import { INotificationService } from 'vs/platform/notification/common/notification';
 import { IKeyMods, IPickOptions, IQuickInputButton, IQuickInputService, IQuickPickItem, IQuickPickSeparator } from 'vs/platform/quickinput/common/quickInput';
 import { ITelemetryService } from 'vs/platform/telemetry/common/telemetry';
-import { ICreateContributedTerminalProfileOptions, IExtensionTerminalProfile, IShellLaunchConfig, ITerminalLaunchError, ITerminalProfile, ITerminalProfileObject, ITerminalProfileType, ITerminalsLayoutInfo, ITerminalsLayoutInfoById, TerminalLocation, TerminalLocationString, TerminalSettingId, TerminalSettingPrefix } from 'vs/platform/terminal/common/terminal';
+import { ICreateContributedTerminalProfileOptions, IExtensionTerminalProfile, IShellLaunchConfig, ITerminalLaunchError, ITerminalProfile, ITerminalProfileObject, ITerminalProfileType, ITerminalsLayoutInfo, ITerminalsLayoutInfoById, TerminalLocation, TerminalLocationString, TerminalSettingId, TerminalSettingPrefix, TitleEventSource } from 'vs/platform/terminal/common/terminal';
 import { registerTerminalDefaultProfileConfiguration } from 'vs/platform/terminal/common/terminalPlatformConfiguration';
 import { iconForeground } from 'vs/platform/theme/common/colorRegistry';
 import { IconDefinition } from 'vs/platform/theme/common/iconRegistry';
@@ -50,6 +50,7 @@ import { ILifecycleService, ShutdownReason, WillShutdownEvent } from 'vs/workben
 import { IRemoteAgentService } from 'vs/workbench/services/remote/common/remoteAgentService';
 import { ACTIVE_GROUP, SIDE_GROUP } from 'vs/workbench/services/editor/common/editorService';
 import { IEditorGroupsService } from 'vs/workbench/services/editor/common/editorGroupsService';
+import { template } from 'vs/base/common/labels';
 
 export class TerminalService implements ITerminalService {
 	declare _serviceBrand: undefined;
@@ -255,6 +256,12 @@ export class TerminalService implements ITerminalService {
 				e.affectsConfiguration(TerminalSettingPrefix.Profiles + platformKey) ||
 				e.affectsConfiguration(TerminalSettingId.UseWslProfiles)) {
 				this._refreshAvailableProfiles();
+			} else if (
+				e.affectsConfiguration(TerminalSettingId.TerminalTitle) ||
+				e.affectsConfiguration(TerminalSettingId.TerminalTitleSeparator)) {
+				this._updateTitles();
+			} else if (e.affectsConfiguration(TerminalSettingId.TerminalDescription)) {
+				this._updateDescriptions();
 			}
 		});
 
@@ -305,6 +312,45 @@ export class TerminalService implements ITerminalService {
 
 		// Create async as the class depends on `this`
 		timeout(0).then(() => this._instantiationService.createInstance(TerminalEditorStyle, document.head));
+		this.onDidChangeActiveInstance(async () => {
+			this._updateTitles();
+			await this._updateDescriptions();
+		});
+	}
+
+	private _updateTitles(): void {
+		for (const terminal of this.instances) {
+			const title = this._configHelper.config.title;
+			const separator = this._configHelper.config.spacer;
+			const newTitle = template(title, {
+				process: terminal.name,
+				sequence: 'fsdfsdf',
+				separator: { label: separator }
+			});
+			if (terminal.title !== newTitle) {
+				terminal.setTitle(newTitle, TitleEventSource.Api);
+				const pane = this._viewsService.getActiveViewWithId<TerminalViewPane>(TERMINAL_VIEW_ID);
+				pane?.terminalTabbedView?.rerenderTabs();
+			}
+		}
+	}
+
+	private async _updateDescriptions(): Promise<void> {
+		for (const terminal of this.instances) {
+			const description = this._configHelper.config.description;
+			const separator = this._configHelper.config.spacer;
+			const cwd = await terminal.getCwd();
+			if (description !== terminal.shellLaunchConfig.description) {
+				terminal.description = template(description, {
+					task: terminal.shellLaunchConfig.description === 'Task' ? 'Task' : undefined,
+					local: !!terminal.isRemote ? 'Local' : undefined,
+					cwd,
+					separator: { label: separator }
+				});
+			}
+			const pane = this._viewsService.getActiveViewWithId<TerminalViewPane>(TERMINAL_VIEW_ID);
+			pane?.terminalTabbedView?.rerenderTabs();
+		}
 	}
 
 	getOffProcessTerminalService(): IOffProcessTerminalService | undefined {
@@ -451,7 +497,9 @@ export class TerminalService implements ITerminalService {
 		// The state must be updated when the terminal is relaunched, otherwise the persistent
 		// terminal ID will be stale and the process will be leaked.
 		this.onDidReceiveProcessId(() => this._saveState());
-		this.onDidChangeInstanceTitle(instance => this._updateTitle(instance));
+		this.onDidChangeInstanceTitle(instance => {
+			this._updateTitle(instance);
+		});
 		this.onDidChangeInstanceIcon(instance => this._updateIcon(instance));
 	}
 

src/vs/workbench/contrib/terminal/browser/terminalTabbedView.ts

@@ -171,7 +171,7 @@ export class TerminalTabbedView extends Disposable {
 				this._addTabTree();
 				this._addSashListener();
 				this._splitView.resizeView(this._tabTreeIndex, this._getLastListWidth());
-				this._rerenderTabs();
+				this.rerenderTabs();
 			}
 		} else {
 			if (this._splitView.length === 2 && !this._terminalTabsMouseContextKey.get()) {
@@ -244,7 +244,7 @@ export class TerminalTabbedView extends Disposable {
 			width = TerminalTabsListSizes.WideViewMinimumWidth;
 			this._splitView.resizeView(this._tabTreeIndex, width);
 		}
-		this._rerenderTabs();
+		this.rerenderTabs();
 		const widthKey = this._panelOrientation === Orientation.VERTICAL ? TerminalStorageKeys.TabsListWidthVertical : TerminalStorageKeys.TabsListWidthHorizontal;
 		this._storageService.store(widthKey, width, StorageScope.GLOBAL, StorageTarget.USER);
 	}
@@ -279,10 +279,10 @@ export class TerminalTabbedView extends Disposable {
 			onDidChange: () => Disposable.None,
 			priority: LayoutPriority.Low
 		}, Sizing.Distribute, this._tabTreeIndex);
-		this._rerenderTabs();
+		this.rerenderTabs();
 	}
 
-	private _rerenderTabs() {
+	rerenderTabs() {
 		const hasText = this._tabListElement.clientWidth > TerminalTabsListSizes.MidpointViewWidth;
 		this._tabContainer.classList.toggle('has-text', hasText);
 		this._terminalIsTabsNarrowContextKey.set(!hasText);
@@ -294,7 +294,7 @@ export class TerminalTabbedView extends Disposable {
 		this._sashDisposables = [
 			this._splitView.sashes[0].onDidStart(e => {
 				interval = window.setInterval(() => {
-					this._rerenderTabs();
+					this.rerenderTabs();
 				}, 100);
 			}),
 			this._splitView.sashes[0].onDidEnd(e => {
@@ -318,7 +318,7 @@ export class TerminalTabbedView extends Disposable {
 		if (this._shouldShowTabs()) {
 			this._splitView.resizeView(this._tabTreeIndex, this._getLastListWidth());
 		}
-		this._rerenderTabs();
+		this.rerenderTabs();
 	}
 
 	private _updateTheme(theme?: IColorTheme): void {

src/vs/workbench/contrib/terminal/browser/terminalTabsList.ts

@@ -348,7 +348,7 @@ class TerminalTabsRenderer implements IListRenderer<ITerminalInstance, ITerminal
 		template.label.setResource({
 			resource: instance.resource,
 			name: label,
-			description: hasText ? instance.shellLaunchConfig.description : undefined
+			description: hasText ? instance.shellLaunchConfig.description ? instance.shellLaunchConfig.description : instance.description : undefined
 		}, {
 			fileDecorations: {
 				colors: true,

src/vs/workbench/contrib/terminal/common/terminal.ts

@@ -205,6 +205,9 @@ export interface ITerminalConfiguration {
 	bellDuration: number;
 	defaultLocation: TerminalLocationString;
 	customGlyphs: boolean;
+	title: string;
+	description: string;
+	spacer: string;
 }
 
 export const DEFAULT_LOCAL_ECHO_EXCLUDE: ReadonlyArray<string> = ['vim', 'vi', 'nano', 'tmux'];

src/vs/workbench/contrib/terminal/common/terminalConfiguration.ts

@@ -9,6 +9,20 @@ import { DEFAULT_LETTER_SPACING, DEFAULT_LINE_HEIGHT, TerminalCursorStyle, DEFAU
 import { TerminalLocationString, TerminalSettingId } from 'vs/platform/terminal/common/terminal';
 import { isMacintosh, isWindows } from 'vs/base/common/platform';
 import { Registry } from 'vs/platform/registry/common/platform';
+let terminalTitleDescription = localize('terminalTitle', "Controls the terminal title. Variables are substituted based on the context:");
+terminalTitleDescription += '\n- ' + [
+	localize('process', "`\${process}`: the name of the terminal process"),
+	localize('sequence', "`\${sequence}`: a sequence"),
+	localize('separator', "`\${separator}`: a conditional separator (\" - \") that only shows when surrounded by variables with values or static text.")
+].join('\n- '); // intentionally concatenated to not produce a string that is too long for translations
+
+let terminalDescriptionDescription = localize('terminalDescription', "Controls the terminal description, which appears to the right of the title. Variables are substituted based on the context:");
+terminalDescriptionDescription += '\n- ' + [
+	localize('task', "`\${process}`: indicates this terminal is associated with a task"),
+	localize('local', "`\${local}`: indicates a local terminal in a remote workspace"),
+	localize('cwd', "`\${cwd}`: the terminal's current working directory"),
+	localize('separator', "`\${separator}`: a conditional separator (\" - \") that only shows when surrounded by variables with values or static text.")
+].join('\n- '); // intentionally concatenated to not produce a string that is too long for translations
 
 const terminalConfiguration: IConfigurationNode = {
 	id: 'terminal',
@@ -247,6 +261,28 @@ const terminalConfiguration: IConfigurationNode = {
 			default: 'auto',
 			description: localize('terminal.integrated.gpuAcceleration', "Controls whether the terminal will leverage the GPU to do its rendering.")
 		},
+		[TerminalSettingId.TerminalTitleSeparator]: {
+			'type': 'string',
+			'default': isMacintosh ? ' — ' : ' - ',
+			'markdownDescription': localize("terminal.integrated.spacer", "Separator used by `terminal.integrated.title` and `terminal.integrated.description`.")
+		},
+		[TerminalSettingId.TerminalTitle]: {
+			'type': 'string',
+			'default': (() => {
+				const base = '${process}';
+				return base;
+			})(),
+			'markdownDescription': terminalTitleDescription
+		},
+		[TerminalSettingId.TerminalDescription]: {
+			'type': 'string',
+			'default': (() => {
+				const base = '${task}${separator}${local}${separator}${cwd}';
+				return base;
+			})(),
+			'markdownDescription': terminalDescriptionDescription
+
+		},
 		[TerminalSettingId.RightClickBehavior]: {
 			type: 'string',
 			enum: ['default', 'copyPaste', 'paste', 'selectWord'],