# Set Contextual Terminal Titles

Long AI sessions can make terminal windows hard to identify. This skill updates the title with the active project, topic, and emoji context.

## Install

```bash
npx skillstore add 2389-research/terminal-title
```

## Metadata

- - Status: approved
- - Slug: 2389-research-terminal-title
- - Version: 1.0.0
- - Author: 2389-research
- - GitHub username: 2389-research
- - License: MIT
- - Repository: https://github.com/2389-research/claude-plugins/tree/main/terminal-title/skills
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: medium
- - Risk factors: scripts, external\_commands, filesystem
- - Quality score: 73
- - Public page: https://skillstore.pages.dev/skills/2389-research-terminal-title
- - Manifest: https://skillstore.pages.dev/api/skills/2389-research-terminal-title/manifest

## Capabilities

- Sets terminal window titles with project and topic context.
- Reads an optional emoji from the terminal environment.
- Supports Unix-like shells through a Bash helper script.
- Supports Windows terminals through a PowerShell helper script.
- Removes control characters and limits title component length.
- Provides workflow guidance for session starts and topic changes.

## Use Cases

- Track Active Coding Sessions: Show the current project and work topic in each terminal window.
- Separate Work and Personal Contexts: Use an environment emoji to distinguish work directories from personal projects.
- Keep Pairing Sessions Oriented: Update titles when the discussion moves between debugging, documentation, tests, or features.

## Prompt Templates

### Set a Basic Title

```
Set my terminal title for this project as My App and the topic as Authentication.
```

### Use Current Context

```
Update the terminal title using the current project name and this conversation topic.
```

### Change Topics During Work

```
We are moving from frontend fixes to database migrations. Update the terminal title for the new topic.
```

### Review Title Automation

```
Review how this skill sets terminal titles and explain what permission it needs before I enable it.
```

## Limitations

- Requires permission to run the bundled local script.
- Depends on terminal support for title escape sequences.
- Project and topic names rely on AI context detection.
- Does not manage terminal tabs outside the active session.

## Best Practices

- Review the local scripts before granting command permissions.
- Keep project and topic names short enough for your terminal title bar.
- Use a trusted environment variable if you customize the emoji.

## Anti Patterns

- Do not grant broad command permissions beyond the bundled title scripts.
- Do not use untrusted text as a title without sanitization.
- Do not expect title updates in terminals that ignore title escape sequences.

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-27T15:51:14.507\+00:00
- - Summary: Static analysis found many external command, filesystem, obfuscation, weak crypto, and reconnaissance patterns. Review confirms the scripts are local title-setting helpers with input sanitization and no evidence of network access, credential collection, or malicious intent. The remaining concern is automatic, pre-approved script execution that writes terminal escape sequences, so publication should include a clear warning.

## Stats

- - Views: 175
- - Downloads: 7
- - Favorites: 0
- - Popularity score: 0