![npm version](https://npmjs.com/package/ttab) ![license](https://github.com/mklement0/ttab/blob/master/LICENSE.md)

Contents

- ttab — programmatically open a new terminal tab or window
- Installation
- Installation via Homebrew (macOS only)
- Installation from the npm registry
- Manual installation
- Examples
- Usage
- License
- Acknowledgements
- npm dependencies
- Changelog

ttab — programmatically open a new terminal tab or window

A CLI for Unix-like platforms that programmatically opening a new terminal tab/window in one of the following terminal applications, optionally with a command to execute and/or a specific title and specific display settings (profile).

- On macOS: either Terminal (the default terminal emulator) or popular alternative iTerm2.
- On Linux, Gnome Terminal (gnome-terminal), thanks to a contribution by @ksvirsky.
- Note: ttab does _not_ support Windows; consider using the Windows Terminal-based wttab utility there.

Note: iTerm2 and gnome-terminal support is currently not covered by the automated tests run before every release.

Installation

Important: On macOS, irrespective of installation method, Terminal / iTerm2 (iTerm.app) needs to be granted _access for assistive devices_ in order for ttab to function properly, which is a _one-time operation that requires administrative privileges_.
If you're not prompted on first run and get an error message instead, go to System Preferences > Security & Privacy, tab Privacy, select Accessibility, unlock, and make sure Terminal.app / iTerm.app is in the list on the right and has a checkmark.
For more information, see Apple's support article on the subject.

Installation via Homebrew (macOS only)

With Homebrew installed, run the following:

``sh brew tap mklement0/ttab https://github.com/mklement0/ttab.git brew install mklement0/ttab/ttab`

Note:

- The Homebrew version may lag behind the npm registry version if later versions relate solely to the Linux-only Gnome Terminal functionality. - To upgradettab to the latest version, run brew upgrade ttab. - To removettab later, run brew rm ttab.

`Installation from the npm registry`

With Node.js installed, install from the npm registry:

[sudo] npm install ttab -g

Note:

- Whether you need sudo depends on how you installed Node.js and whether you've changed permissions later; if you get an EACCES error, try again with sudo. - The-g ensures _global_ installation and is needed to put ttab in your system's $PATH.

`Manual installation`

- Download this bash script as ttab. - Make it executable withchmod +x ttab. - Move it to a folder in your$PATH, such as /usr/local/bin.

`Examples`

`shell

`Open a new tab in the current terminal window.`


ttab
Open a new tab in a new terminal window.

ttab -w
Open new horizontal split tab in the current terminal window:

ttab -h
Open new vertical split tab in the current terminal window, changing the path to the

given path, but without checking the presence of the target directory:

ttab -v -i -d "$HOME/Library/Application Support"
Open a new tab and execute the specified command before showing the prompt.

ttab ls -l "$HOME/Library/Application Support"
Open a new tab and execute the specified command after a delay of 0.8 secs,

to accommodate shells with lengthy initialization-file processing.

Note: You may preset the delay via environment variable TTAB_CMD_DELAY

ttab -l 0.8 ls -1
Open a new tab and execute multiple commands in it - note how the entire

command line is specified as single, quoted string.

ttab 'git branch; git status'
Open a new tab, switch to the specified dir., then execute the specified

command before showing the prompt.

ttab -d ~/Library/Application\ Support ls -1
Open a new tab with title 'How Green Was My Valley' and settings 'Grass'.

See the note re use of -t in iTerm2 below.

ttab -t 'How Green Was My Valley' -s Grass
Open a new tab and execute the specified script before showing the prompt.

ttab /path/to/someScript
Open a new tab, execute the specified script, and exit.

ttab exec /path/to/someScript
Open a new tab, execute a command, wait for a keypress, and exit.

ttab 'ls "$HOME/Library/Application Support"; echo Press a key to exit.; read -rsn 1; exit'
Open a new tab in iTerm2 (if installed).

ttab -a iTerm2 echo 'Hi from iTerm2.'
Execute the command in the current tab of the current terminal window:

ttab -c 'ls "$HOME/Library/Application Support"'


Usage

Find concise usage information below; for complete documentation, read the manual online, or, once installed, run man ttab (ttab --man if installed manually).

`nohighlight $ ttab --help

Opens a new terminal tab or window, on macOS in either Terminal.app or iTerm2.app; on Linux in Gnome Terminal, if available.

ttab [-w|-v|-h|-c] [-i] [-s ] [-t ] [-q] [-g|-G] [-d <dir>] [<cmd> ...]</p><p class="my-3"> -w Open new tab in new terminal window.<br /> -v iTerm only: create a new vertical split<br /> -h iTerm only: create a new horizontal split<br /> -c Terminal/iTerm only: do not open any new window or<br /> tab, run in the current tab of the current window.<br /> -i Suppress up-front verification of the existence of<br /> the target directory specified via the -d option.<br /> -s <settings> Assign a settings set (profile).<br /> -t <title> Specify title for new tab.<br /> -q Clear the new tab's screen.<br /> -g Terminal/iTerm only: create in background (don't<br /> activate application).<br /> -G Terminal/iTerm: don't activate new tab and create in<br /> background.<br /> gnome-terminal: don't activate new tab, except with -w.<br /> -d <dir> Specify working directory; -d '' disables inheriting<br /> the current dir. in Terminal/iTerm.<br /> -l <secs> Terminal/iTerm only: delay startup command submission;<br /> may be preset via env. var. TTAB_CMD_DELAY<br /> -a Terminal | iTerm Open the new tab in the given terminal app on macOS.<br /> <cmd> ... Command to execute in the new tab.<br /> "<cmd> ...; ..." Multi-command command line (passed as single operand).</p><p class="my-3">Standard options: --help, --man, --version, --home<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">Note to <strong>iTerm2 users</strong>: The </code>-t<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> option for specifying a title only works if<br />the new tab's active profile is configured to show the session name in the<br />title, which can be configured via the Preferences dialog as shown by<br />@francis-lookback <a href="https://github.com/mklement0/ttab/issues/23#issuecomment-645210109" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">here</a>.</p><p class="my-3"></p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">License</h1></p><p class="my-3">Copyright (c) 2015-2024 Michael Klement <mklement0@gmail.com> (http://same2u.net), released under the <a href="https://spdx.org/licenses/MIT#licenseText" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">MIT license</a>.</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">Acknowledgements</h2></p><p class="my-3">A thank you to all contributors to this repo, especially the following major ones:</p><p class="my-3">* <a href="https://github.com/ksvirsky" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">@ksvirsky</a><br />* <a href="https://github.com/HofiOne" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">@HofiOne</a></p><p class="my-3">This project gratefully depends on the following open-source components, according to the terms of their respective licenses.</p><p class="my-3"><a href="https://www.npmjs.com/" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">npm</a> dependencies below have optional suffixes denoting the type of dependency; the _absence_ of a suffix denotes a required _run-time_ dependency: </code>(D)<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> denotes a _development-time-only_ dependency, </code>(O)<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> an _optional_ dependency, and </code>(P)<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> a _peer_ dependency.</p><p class="my-3"></p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">npm dependencies</h2></p><p class="my-3">* [doctoc (D)]()<br />* [json (D)]()<br />* <a href="https://marked.js.org" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">marked (D)</a><br />* [marked-man (D)]()<br />* [replace (D)]()<br />* [semver (D)]()<br />* <a href="http://www.node-tap.org/" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">tap (D)</a><br />* [urchin (D)]()</p><p class="my-3"></p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Changelog</h1></p><p class="my-3">Versioning complies with <a href="http://semver.org/" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">semantic versioning (semver)</a>.</p><p class="my-3"></p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.8.0...v0.9.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.9.0</a></strong> (2024-05-22):<br /> * [enhancement] Thanks to <a href="https://github.com/HofiOne" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">@HofiOne</a>, </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now supports new macOS-focused options, </code>-h<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>-v<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>-c<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, and </code>-i<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, <br /> which notably includes support for splitting the current tab horizontally (</code>-h<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">) or vertically (</code>-v<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">) in iTerm2.<br /> * [fix] Attempts to use options that are not supported in the target terminal now consistently result in errors.<br /> * [breaking change] Since </code>-h<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now requests horizontal splitting, it can no longer be used to invoke help; use </code>--help<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> instead.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.7.3...v0.8.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.8.0</a></strong> (2023-01-12):<br /> * [enhancement] New </code>-l<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> option / env. var. </code>TTAB_CMD_DELAY<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> allows specifying a delay before submitting a startup command to a new tab, to accommodate shells whose initialization-file processing takes a while (iTerminal / iTerm2 only).</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.7.2...v0.7.3" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.7.3</a></strong> (2022-08-11):<br /> * [fix] for #43; the way that keeping the shell alive is emulated in Gnome Terminal now also works when the startup command is aborted with Ctrl-C.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.7.1...v0.7.2" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.7.2</a></strong> (2021-10-26):<br /> * [fix] for #39; </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now works correctly when iTerm's "Exclude from Dock and ⌘-Tab Application Switcher" preference is enabled, albeit without support for </code>-g<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> and </code>-G<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, for technical reasons.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.7.0...v0.7.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.7.1</a></strong> (2021-04-06):<br /> * [fix] Fix for #13: </code>-g<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> and </code>-G<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now work in macOS Big Sur too.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.6.1...v0.7.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.7.0</a></strong> (2020-08-24):<br /> * [enhancement] Thanks to <a href="https://github.com/ksvirsky" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">@ksvirsky</a>, </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> is now also available on Linux, assuming </code>gnome-terminal<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> is available.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.6.0...v0.6.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.6.1</a></strong> (2017-11-08):<br /> * [fix] macOS 10.13 (High Sierra compatibility), which makes </code>-G<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> work again.<br /> * [installation] Homebrew formula added (added post-release, on 2019-12-22).</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.5.1...v0.5.2" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.6.0</a></strong> (2017-06-21):<br /> * [enhancement] </code>-d ''<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now prevents </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> from implicitly changing to what<br /> it thinks the working directory should be; useful for creating tabs/windows<br /> that set their own working directory.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.5.0...v0.5.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.5.1</a></strong> (2017-03-23):<br /> * [doc] Sample command fixed.<br /> * [dev] Reliability of tests improved.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.4.0...v0.5.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.5.0</a></strong> (2016-10-01):<br /> * [new feature] </code>-q<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now allows clearing the "screen" of the new tab after<br /> opening using </code>clear<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, assuming any command (list) passed succeeded.<br /> * [enhancement] A quoted multi-command shell command string can now be <br /> specified as a single - and only - operand, without having to precede with<br /> an explicit </code>eval<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> command. <br /> * [behavior change] If no custom title is specified with </code>-t <title><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, no<br /> attempt is made anymore to auto-derive a meaningful tab title from the<br /> shell command specified, as there is no heuristic that works well in all<br /> cases.<br /> * [fix] <a href="https://github.com/mklement0/ttab/issues/7" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">Issue #7</a>: iTerm2<br /> now also preserves the current working dir. when opening a new tab in the <br /> current window.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.3.1...v0.4.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.4.0</a></strong> (2016-09-13):<br /> * [enhancement] </code>-a Terminal|iTerm2<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now allows specifying the target Terminal<br /> application, which is useful for launching </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> from non-terminal applications<br /> such as <a href="http://alfredapp.com" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">Alfred</a>.<br /> * [fix] Specifying a syntactically invalid shell command to execute in the<br /> new tab now causes </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> to report a nonzero exit code.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.3.0...v0.3.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.3.1</a></strong> (2016-06-03):<br /> * [enhancement] Support for iTerm2 v3 added (whose AppleScript syntax changed fundamentally)<br /> * [enhancement] Setting a tab title is now also supported in iTerm2 v2.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.2.1...v0.3.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.3.0</a></strong> (2016-05-04):<br /> * [enhancement] Experimental support for iTerm2 (</code>iTerm.app<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">) added.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.2.0...v0.2.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.2.1</a></strong> (2015-09-15):<br /> * [dev] Makefile improvements; various other behind-the-scenes tweaks.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.1.8...v0.2.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.2.0</a></strong> (2015-09-14):<br /> * [enhancement] You can now use embedded (escaped, if necessary) double-quotes inside a multi-command string passed via </code>eval<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">.<br /> * [doc] If installed via the npm registry, a man page is now installed (view with </code>man ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">); if installed manually, </code>ttab --man<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><br /> shows a plain-text version. </code>ttab -h<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now only prints concise, single-page usage information.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.1.7...v0.1.8" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.1.8</a></strong> (2015-09-11):<br /> * [doc] Incorrect new-window option corrected in examples.<br /> * [doc, dev] Read-me improved together with the Makefile to turn off syntax highlighting for the CLI help chapter.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.1.6...v0.1.7" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.1.7</a></strong> (2015-06-26):<br /> * [doc] Read-me: npm badge changed to shields.io; license badge added.<br /> * [dev] Makefile updated.</p><p class="my-3">* <strong>v0.1.6</strong> (2015-06-01):<br /> * [doc] Read-me improvements; typo in CLI usage help fixed.</p><p class="my-3">* <strong>v0.1.5</strong> (2015-06-01):<br /> * [doc] Improved CLI usage help.</p><p class="my-3">* <strong>v0.1.4</strong> (2015-06-01):<br /> * [doc] Improved CLI usage help; keywords added to </code>package.json<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">.<br /> * [dev] </code>make browse` now opens the GitHub repo in the default browser.</p><p class="my-3">* <strong>v0.1.3</strong> (2015-06-01):<br /> * [fix] The -g and -G options again correctly do not activate Terminal.app when creating the desired tab.<br /> * [enhancement] Option parsing now accepts option-arguments directly attached to the option.<br /> * [dev] Tests added.</p><p class="my-3">* <strong>v0.1.2</strong> (2015-06-01):<br /> * [doc] Manual-installation link and instructions fixed; examples fixed.</p><p class="my-3">* <strong>v0.1.1</strong> (2015-06-01):<br /> * [doc] README.md improved with respect to manual installation instructions.</p><p class="my-3">* <strong>v0.1.0</strong> (2015-06-01):<br /> * Initial release.<br /></p></div><div class="flex justify-center absolute inset-x-0 bottom-0 bg-gradient-to-t from-background via-background to-transparent pb-4 pt-16"><button data-slot="button" class="inline-flex items-center justify-center whitespace-nowrap text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50 h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down mr-1 h-4 w-4"><path d="m6 9 6 6 6-6"></path></svg>Show more</button></div></div></div><template id="P:3"></template><template id="P:4"></template></div></div><div class="space-y-8"><div class="flex flex-col gap-6 lg:flex-row lg:gap-8"><div class="flex-1 space-y-4"><div data-slot="skeleton" class="bg-accent animate-pulse rounded-md h-10 w-64"></div><div data-slot="skeleton" class="bg-accent animate-pulse rounded-md h-6 w-full max-w-xl"></div><div class="flex gap-2"><div data-slot="skeleton" class="bg-accent animate-pulse rounded-md h-6 w-16"></div><div data-slot="skeleton" class="bg-accent animate-pulse rounded-md h-6 w-20"></div><div data-slot="skeleton" class="bg-accent animate-pulse rounded-md h-6 w-14"></div></div></div><div class="w-full lg:w-80"><div data-slot="skeleton" class="bg-accent animate-pulse rounded-md h-32 w-full"></div></div></div><div class="space-y-4"><div data-slot="skeleton" class="bg-accent animate-pulse rounded-md h-10 w-64"></div><div data-slot="skeleton" class="bg-accent animate-pulse rounded-md h-64 w-full"></div></div></div></main></div><script>requestAnimationFrame(function(){$RT=performance.now()});</script><script src="/_next/static/chunks/9b9784636e791b20.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd" id="_R_" async=""></script><script>(self.__next_f=self.__next_f||[]).push([0])</script><script>self.__next_f.push([1,"1:\"$Sreact.fragment\"\n2:I[39756,[\"/_next/static/chunks/ff1a16fafef87110.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/d2be314c3ece3fbe.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"default\"]\n3:I[37457,[\"/_next/static/chunks/ff1a16fafef87110.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/d2be314c3ece3fbe.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"default\"]\n4:I[49786,[\"/_next/static/chunks/d25c1c87321c1e5e.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/d23d08e0b5d1d215.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/ae55acb14c32e044.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"Header\"]\n5:I[22016,[\"/_next/static/chunks/d25c1c87321c1e5e.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/d23d08e0b5d1d215.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/ae55acb14c32e044.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"\"]\nc:I[68027,[\"/_next/static/chunks/ff1a16fafef87110.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/d2be314c3ece3fbe.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"default\"]\nd:I[2355,[\"/_next/static/chunks/d25c1c87321c1e5e.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"Analytics\"]\nf:I[97367,[\"/_next/static/chunks/ff1a16fafef87110.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/d2be314c3ece3fbe.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"OutletBoundary\"]\n10:\"$Sreact.suspense\"\n12:I[97367,[\"/_next/static/chunks/ff1a16fafef87110.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/d2be314c3ece3fbe.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"ViewportBoundary\"]\n14:I[97367,[\"/_next/static/chunks/ff1a16fafef87110.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/d2be314c3ece3fbe.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"MetadataBoundary\"]\n:HL[\"/_next/static/chunks/60ba853f5ed1b16b.css?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"style\"]\n:HL[\"/_next/static/chunks/9c76f6dd8b5c38e2.css?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"style\"]\n:HL[\"/_next/static/media/68d403cf9f2c68c5-s.p.f9f15f61.woff2\",\"font\",{\"crossOrigin\":\"\",\"type\":\"font/woff2\"}]\n:HL[\"/_next/static/media/797e433ab948586e-s.p.dbea232f.woff2\",\"font\",{\"crossOrigin\":\"\",\"type\":\"font/woff2\"}]\n:HL[\"/_next/static/media/caa3a2e1cccd8315-s.p.853070df.woff2\",\"font\",{\"crossOrigin\":\"\",\"type\":\"font/woff2\"}]\n"])</script><script>self.__next_f.push([1,"0:{\"P\":null,\"b\":\"x_DymHuNhDTJUp7Mmr_Ru\",\"c\":[\"\",\"package\",\"ttab\"],\"q\":\"\",\"i\":false,\"f\":[[[\"\",{\"children\":[\"package\",{\"children\":[[\"name\",\"ttab\",\"c\"],{\"children\":[\"__PAGE__\",{}]}]}]},\"$undefined\",\"$undefined\",true],[[\"$\",\"$1\",\"c\",{\"children\":[[[\"$\",\"link\",\"0\",{\"rel\":\"stylesheet\",\"href\":\"/_next/static/chunks/60ba853f5ed1b16b.css?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"precedence\":\"next\",\"crossOrigin\":\"$undefined\",\"nonce\":\"$undefined\"}],[\"$\",\"link\",\"1\",{\"rel\":\"stylesheet\",\"href\":\"/_next/static/chunks/9c76f6dd8b5c38e2.css?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"precedence\":\"next\",\"crossOrigin\":\"$undefined\",\"nonce\":\"$undefined\"}],[\"$\",\"script\",\"script-0\",{\"src\":\"/_next/static/chunks/d25c1c87321c1e5e.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"async\":true,\"nonce\":\"$undefined\"}]],[\"$\",\"html\",null,{\"lang\":\"en\",\"children\":[\"$\",\"body\",null,{\"className\":\"font-sans antialiased\",\"children\":[[\"$\",\"$L2\",null,{\"parallelRouterKey\":\"children\",\"error\":\"$undefined\",\"errorStyles\":\"$undefined\",\"errorScripts\":\"$undefined\",\"template\":[\"$\",\"$L3\",null,{}],\"templateStyles\":\"$undefined\",\"templateScripts\":\"$undefined\",\"notFound\":[[\"$\",\"div\",null,{\"className\":\"min-h-screen bg-background\",\"children\":[[\"$\",\"$L4\",null,{}],[\"$\",\"main\",null,{\"className\":\"mx-auto flex max-w-md flex-col items-center justify-center px-4 py-24 text-center\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-package mb-6 h-16 w-16 text-muted-foreground\",\"children\":[[\"$\",\"path\",\"1a0edw\",{\"d\":\"M11 21.73a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73z\"}],[\"$\",\"path\",\"d0xqtd\",{\"d\":\"M12 22V12\"}],[\"$\",\"path\",\"yx3hmr\",{\"d\":\"m3.3 7 7.703 4.734a2 2 0 0 0 1.994 0L20.7 7\"}],[\"$\",\"path\",\"1c824w\",{\"d\":\"m7.5 4.27 9 5.15\"}],\"$undefined\"]}],[\"$\",\"h1\",null,{\"className\":\"mb-2 text-3xl font-bold\",\"children\":\"404\"}],[\"$\",\"h2\",null,{\"className\":\"mb-4 text-xl text-muted-foreground\",\"children\":\"Page not found\"}],[\"$\",\"p\",null,{\"className\":\"mb-8 text-muted-foreground\",\"children\":\"The page you're looking for doesn't exist or has been moved.\"}],[\"$\",\"div\",null,{\"className\":\"flex gap-3\",\"children\":[[\"$\",\"$L5\",null,{\"href\":\"/\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-house mr-1.5 h-4 w-4\",\"children\":[[\"$\",\"path\",\"5wwlr5\",{\"d\":\"M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8\"}],[\"$\",\"path\",\"1d0kgt\",{\"d\":\"M3 10a2 2 0 0 1 .709-1.528l7-5.999a2 2 0 0 1 2.582 0l7 5.999A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z\"}],\"$undefined\"]}],\"Go home\"],\"data-slot\":\"button\",\"className\":\"inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [\u0026_svg]:pointer-events-none [\u0026_svg:not([class*='size-'])]:size-4 shrink-0 [\u0026_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive bg-primary text-primary-foreground hover:bg-primary/90 h-9 px-4 py-2 has-[\u003esvg]:px-3\",\"ref\":null}],[\"$\",\"$L5\",null,{\"href\":\"/search\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-search mr-1.5 h-4 w-4\",\"children\":[[\"$\",\"circle\",\"4ej97u\",{\"cx\":\"11\",\"cy\":\"11\",\"r\":\"8\"}],[\"$\",\"path\",\"1qie3q\",{\"d\":\"m21 21-4.3-4.3\"}],\"$undefined\"]}],\"Search packages\"],\"data-slot\":\"button\",\"className\":\"inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [\u0026_svg]:pointer-events-none [\u0026_svg:not([class*='size-'])]:size-4 shrink-0 [\u0026_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50 h-9 px-4 py-2 has-[\u003esvg]:px-3\",\"ref\":null}]]}]]}]]}],[]],\"forbidden\":\"$undefined\",\"unauthorized\":\"$undefined\"}],\"$L6\"]}]}]]}],{\"children\":[\"$L7\",{\"children\":[\"$L8\",{\"children\":[\"$L9\",{},null,false,false]},[\"$La\",[],[]],false,false]},null,false,false]},null,false,false],\"$Lb\",false]],\"m\":\"$undefined\",\"G\":[\"$c\",[]],\"S\":false}\n"])</script><script>self.__next_f.push([1,"6:[\"$\",\"$Ld\",null,{}]\n7:[\"$\",\"$1\",\"c\",{\"children\":[null,[\"$\",\"$L2\",null,{\"parallelRouterKey\":\"children\",\"error\":\"$undefined\",\"errorStyles\":\"$undefined\",\"errorScripts\":\"$undefined\",\"template\":[\"$\",\"$L3\",null,{}],\"templateStyles\":\"$undefined\",\"templateScripts\":\"$undefined\",\"notFound\":\"$undefined\",\"forbidden\":\"$undefined\",\"unauthorized\":\"$undefined\"}]]}]\n8:[\"$\",\"$1\",\"c\",{\"children\":[null,[\"$\",\"$L2\",null,{\"parallelRouterKey\":\"children\",\"error\":\"$undefined\",\"errorStyles\":\"$undefined\",\"errorScripts\":\"$undefined\",\"template\":[\"$\",\"$L3\",null,{}],\"templateStyles\":\"$undefined\",\"templateScripts\":\"$undefined\",\"notFound\":\"$undefined\",\"forbidden\":\"$undefined\",\"unauthorized\":\"$undefined\"}]]}]\n9:[\"$\",\"$1\",\"c\",{\"children\":[\"$Le\",[[\"$\",\"script\",\"script-0\",{\"src\":\"/_next/static/chunks/d23d08e0b5d1d215.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"async\":true,\"nonce\":\"$undefined\"}],[\"$\",\"script\",\"script-1\",{\"src\":\"/_next/static/chunks/ae55acb14c32e044.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"async\":true,\"nonce\":\"$undefined\"}]],[\"$\",\"$Lf\",null,{\"children\":[\"$\",\"$10\",null,{\"name\":\"Next.MetadataOutlet\",\"children\":\"$@11\"}]}]]}]\na:null\nb:[\"$\",\"$1\",\"h\",{\"children\":[null,[\"$\",\"$L12\",null,{\"children\":\"$L13\"}],[\"$\",\"div\",null,{\"hidden\":true,\"children\":[\"$\",\"$L14\",null,{\"children\":[\"$\",\"$10\",null,{\"name\":\"Next.Metadata\",\"children\":\"$L15\"}]}]}],[\"$\",\"meta\",null,{\"name\":\"next-size-adjust\",\"content\":\"\"}]]}]\n"])</script><script>self.__next_f.push([1,"e:[\"$\",\"div\",null,{\"className\":\"min-h-screen bg-background\",\"children\":[[\"$\",\"$L4\",null,{}],[\"$\",\"main\",null,{\"className\":\"mx-auto max-w-6xl px-4 py-8\",\"children\":[\"$\",\"$10\",null,{\"fallback\":[\"$\",\"div\",null,{\"className\":\"space-y-8\",\"children\":[[\"$\",\"div\",null,{\"className\":\"flex flex-col gap-6 lg:flex-row lg:gap-8\",\"children\":[[\"$\",\"div\",null,{\"className\":\"flex-1 space-y-4\",\"children\":[[\"$\",\"div\",null,{\"data-slot\":\"skeleton\",\"className\":\"bg-accent animate-pulse rounded-md h-10 w-64\"}],[\"$\",\"div\",null,{\"data-slot\":\"skeleton\",\"className\":\"bg-accent animate-pulse rounded-md h-6 w-full max-w-xl\"}],[\"$\",\"div\",null,{\"className\":\"flex gap-2\",\"children\":[[\"$\",\"div\",null,{\"data-slot\":\"skeleton\",\"className\":\"bg-accent animate-pulse rounded-md h-6 w-16\"}],[\"$\",\"div\",null,{\"data-slot\":\"skeleton\",\"className\":\"bg-accent animate-pulse rounded-md h-6 w-20\"}],[\"$\",\"div\",null,{\"data-slot\":\"skeleton\",\"className\":\"bg-accent animate-pulse rounded-md h-6 w-14\"}]]}]]}],[\"$\",\"div\",null,{\"className\":\"w-full lg:w-80\",\"children\":[\"$\",\"div\",null,{\"data-slot\":\"skeleton\",\"className\":\"bg-accent animate-pulse rounded-md h-32 w-full\"}]}]]}],[\"$\",\"div\",null,{\"className\":\"space-y-4\",\"children\":[[\"$\",\"div\",null,{\"data-slot\":\"skeleton\",\"className\":\"bg-accent animate-pulse rounded-md h-10 w-64\"}],[\"$\",\"div\",null,{\"data-slot\":\"skeleton\",\"className\":\"bg-accent animate-pulse rounded-md h-64 w-full\"}]]}]]}],\"children\":\"$L16\"}]}]]}]\n"])</script><script>self.__next_f.push([1,"13:[[\"$\",\"meta\",\"0\",{\"charSet\":\"utf-8\"}],[\"$\",\"meta\",\"1\",{\"name\":\"viewport\",\"content\":\"width=device-width, initial-scale=1\"}]]\n"])</script><script>self.__next_f.push([1,"17:I[27201,[\"/_next/static/chunks/ff1a16fafef87110.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\",\"/_next/static/chunks/d2be314c3ece3fbe.js?dpl=dpl_5VNVLvSu6UbYcDkvZSHQ251MMiDd\"],\"IconMark\"]\n11:null\n15:[[\"$\",\"title\",\"0\",{\"children\":\"ttab - npm explorer\"}],[\"$\",\"meta\",\"1\",{\"name\":\"description\",\"content\":\"OSX CLI for opening a new terminal tab/window, optionally with a command to execute and/or display settings\"}],[\"$\",\"link\",\"2\",{\"rel\":\"icon\",\"href\":\"/icon-light-32x32.png\",\"media\":\"(prefers-color-scheme: light)\"}],[\"$\",\"link\",\"3\",{\"rel\":\"icon\",\"href\":\"/icon-dark-32x32.png\",\"media\":\"(prefers-color-scheme: dark)\"}],[\"$\",\"link\",\"4\",{\"rel\":\"icon\",\"href\":\"/icon.svg\",\"type\":\"image/svg+xml\"}],[\"$\",\"link\",\"5\",{\"rel\":\"apple-touch-icon\",\"href\":\"/apple-icon.png\"}],[\"$\",\"$L17\",\"6\",{}]]\n"])</script><title>ttab - npm explorer

`ttab`

v0.9.0

OSX CLI for opening a new terminal tab/window, optionally with a command to execute and/or display settings

macososxterminalitermiterm2clitabswindowsautomateubuntu

0/weekUpdated 1 years agoMITUnpacked: 120.3 KB

Published by Michael Klement

npm install ttab

RepositoryHomepagenpm

![npm version](https://npmjs.com/package/ttab) ![license](https://github.com/mklement0/ttab/blob/master/LICENSE.md)

Contents

- ttab — programmatically open a new terminal tab or window - Installation - Installation via Homebrew (macOS only) - Installation from the npm registry - Manual installation - Examples - Usage - License - Acknowledgements - npm dependencies - Changelog

`ttab — programmatically open a new terminal tab or window`

A CLI for Unix-like platforms that programmatically opening a new terminal tab/window in one of the following terminal applications, optionally with a command to execute and/or a specific title and specific display settings (profile).

- On macOS: either Terminal (the default terminal emulator) or popular alternative iTerm2. - On Linux, Gnome Terminal (gnome-terminal), thanks to a contribution by @ksvirsky. - Note: ttab does _not_ support Windows; consider using the Windows Terminal-based wttab utility there.

Note: iTerm2 and gnome-terminal support is currently not covered by the automated tests run before every release.

`Installation`

Important: On macOS, irrespective of installation method, Terminal / iTerm2 (iTerm.app) needs to be granted _access for assistive devices_ in order for ttab to function properly, which is a _one-time operation that requires administrative privileges_. If you're not prompted on first run and get an error message instead, go to System Preferences > Security & Privacy, tab Privacy, select Accessibility, unlock, and make sure Terminal.app / iTerm.app is in the list on the right and has a checkmark. For more information, see Apple's support article on the subject.

`Installation via Homebrew (macOS only)`

With Homebrew installed, run the following:

``sh brew tap mklement0/ttab https://github.com/mklement0/ttab.git brew install mklement0/ttab/ttab `

Note:

- The Homebrew version may lag behind the npm registry version if later versions relate solely to the Linux-only Gnome Terminal functionality. - To upgrade ttab to the latest version, run brew upgrade ttab. - To remove ttab later, run brew rm ttab.

`Installation from the npm registry`

With Node.js installed, install from the npm registry:

[sudo] npm install ttab -g

Note:

- Whether you need sudo depends on how you installed Node.js and whether you've changed permissions later; if you get an EACCES error, try again with sudo. - The -g ensures _global_ installation and is needed to put ttab in your system's $PATH.

`Manual installation`

- Download this bash script as ttab. - Make it executable with chmod +x ttab. - Move it to a folder in your $PATH, such as /usr/local/bin.

`Examples`

`shell

`Open a new tab in the current terminal window.`


ttab
Open a new tab in a new terminal window.

ttab -w
Open new horizontal split tab in the current terminal window:

ttab -h
Open new vertical split tab in the current terminal window, changing the path to the

given path, but without checking the presence of the target directory:

ttab -v -i -d "$HOME/Library/Application Support"
Open a new tab and execute the specified command before showing the prompt.

ttab ls -l "$HOME/Library/Application Support"
Open a new tab and execute the specified command after a delay of 0.8 secs,

to accommodate shells with lengthy initialization-file processing.

Note: You may preset the delay via environment variable TTAB_CMD_DELAY

ttab -l 0.8 ls -1
Open a new tab and execute multiple commands in it - note how the entire

command line is specified as single, quoted string.

ttab 'git branch; git status'
Open a new tab, switch to the specified dir., then execute the specified

command before showing the prompt.

ttab -d ~/Library/Application\ Support ls -1
Open a new tab with title 'How Green Was My Valley' and settings 'Grass'.

See the note re use of -t in iTerm2 below.

ttab -t 'How Green Was My Valley' -s Grass
Open a new tab and execute the specified script before showing the prompt.

ttab /path/to/someScript
Open a new tab, execute the specified script, and exit.

ttab exec /path/to/someScript
Open a new tab, execute a command, wait for a keypress, and exit.

ttab 'ls "$HOME/Library/Application Support"; echo Press a key to exit.; read -rsn 1; exit'
Open a new tab in iTerm2 (if installed).

ttab -a iTerm2 echo 'Hi from iTerm2.'
Execute the command in the current tab of the current terminal window:

ttab -c 'ls "$HOME/Library/Application Support"'
`
Usage
Find concise usage information below; for complete documentation, read the manual online, or, once installed, run man ttab (ttab --man if installed manually).
`nohighlight
$ ttab --help

Opens a new terminal tab or window, on macOS in either Terminal.app or  
iTerm2.app; on Linux in Gnome Terminal, if available.
    ttab [-w|-v|-h|-c] [-i] [-s ] [-t ] [-q] [-g|-G] [-d <dir>] [<cmd> ...]</p><p class="my-3">    -w                  Open new tab in new terminal window.<br />    -v                  iTerm only: create a new vertical split<br />    -h                  iTerm only: create a new horizontal split<br />    -c                  Terminal/iTerm only: do not open any new window or<br />                        tab, run in the current tab of the current window.<br />    -i                  Suppress up-front verification of the existence of<br />                        the target directory specified via the -d option.<br />    -s <settings>       Assign a settings set (profile).<br />    -t <title>          Specify title for new tab.<br />    -q                  Clear the new tab's screen.<br />    -g                  Terminal/iTerm only: create in background (don't<br />                        activate application).<br />    -G                  Terminal/iTerm: don't activate new tab and create in<br />                        background.<br />                        gnome-terminal: don't activate new tab, except with -w.<br />    -d <dir>            Specify working directory; -d '' disables inheriting<br />                        the current dir. in Terminal/iTerm.<br />    -l <secs>           Terminal/iTerm only: delay startup command submission;<br />                        may be preset via env. var. TTAB_CMD_DELAY<br />    -a Terminal | iTerm Open the new tab in the given terminal app on macOS.<br />    <cmd> ...           Command to execute in the new tab.<br />    "<cmd> ...; ..."    Multi-command command line (passed as single operand).</p><p class="my-3">Standard options: --help, --man, --version, --home<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">Note to <strong>iTerm2 users</strong>: The </code>-t<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> option for specifying a title only works if<br />the new tab's active profile is configured to show the session name in the<br />title, which can be configured via the Preferences dialog as shown by<br />@francis-lookback <a href="https://github.com/mklement0/ttab/issues/23#issuecomment-645210109" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">here</a>.</p><p class="my-3"><!-- DO NOT EDIT THE NEXT CHAPTER and RETAIN THIS COMMENT: The next chapter is updated by </code>make update-readme/release<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> with the contents of 'LICENSE.md'. ALSO, LEAVE AT LEAST 1 BLANK LINE AFTER THIS COMMENT. --></p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">License</h1></p><p class="my-3">Copyright (c) 2015-2024 Michael Klement <mklement0@gmail.com> (http://same2u.net), released under the <a href="https://spdx.org/licenses/MIT#licenseText" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">MIT license</a>.</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">Acknowledgements</h2></p><p class="my-3">A thank you to all contributors to this repo, especially the following major ones:</p><p class="my-3">* <a href="https://github.com/ksvirsky" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">@ksvirsky</a><br />* <a href="https://github.com/HofiOne" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">@HofiOne</a></p><p class="my-3">This project gratefully depends on the following open-source components, according to the terms of their respective licenses.</p><p class="my-3"><a href="https://www.npmjs.com/" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">npm</a> dependencies below have optional suffixes denoting the type of dependency; the _absence_ of a suffix denotes a required _run-time_ dependency: </code>(D)<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> denotes a _development-time-only_ dependency, </code>(O)<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> an _optional_ dependency, and </code>(P)<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> a _peer_ dependency.</p><p class="my-3"><!-- DO NOT EDIT THE NEXT CHAPTER and RETAIN THIS COMMENT: The next chapter is updated by </code>make update-readme/release<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> with the dependencies from 'package.json'. ALSO, LEAVE AT LEAST 1 BLANK LINE AFTER THIS COMMENT. --></p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">npm dependencies</h2></p><p class="my-3">* [doctoc (D)]()<br />* [json (D)]()<br />* <a href="https://marked.js.org" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">marked (D)</a><br />* [marked-man (D)]()<br />* [replace (D)]()<br />* [semver (D)]()<br />* <a href="http://www.node-tap.org/" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">tap (D)</a><br />* [urchin (D)]()</p><p class="my-3"><!-- DO NOT EDIT THE NEXT CHAPTER and RETAIN THIS COMMENT: The next chapter is updated by </code>make update-readme/release<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> with the contents of 'CHANGELOG.md'. ALSO, LEAVE AT LEAST 1 BLANK LINE AFTER THIS COMMENT. --></p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Changelog</h1></p><p class="my-3">Versioning complies with <a href="http://semver.org/" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">semantic versioning (semver)</a>.</p><p class="my-3"><!-- NOTE: An entry template for a new version is automatically added each time </code>make version<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> is called. Fill in changes afterwards. --></p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.8.0...v0.9.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.9.0</a></strong> (2024-05-22):<br />  * [enhancement] Thanks to <a href="https://github.com/HofiOne" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">@HofiOne</a>, </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now supports new macOS-focused options, </code>-h<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>-v<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>-c<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, and </code>-i<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, <br />    which notably includes support for splitting the current tab horizontally (</code>-h<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">) or vertically (</code>-v<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">) in iTerm2.<br />  * [fix] Attempts to use options that are not supported in the target terminal now consistently result in errors.<br />  * [breaking change] Since </code>-h<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now requests horizontal splitting, it can no longer be used to invoke help; use </code>--help<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> instead.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.7.3...v0.8.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.8.0</a></strong> (2023-01-12):<br />  * [enhancement] New </code>-l<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> option / env. var. </code>TTAB_CMD_DELAY<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> allows specifying a delay before submitting a startup command to a new tab, to accommodate shells whose initialization-file processing takes a while (iTerminal / iTerm2 only).</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.7.2...v0.7.3" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.7.3</a></strong> (2022-08-11):<br />  * [fix] for #43; the way that keeping the shell alive is emulated in Gnome Terminal now also works when the startup command is aborted with Ctrl-C.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.7.1...v0.7.2" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.7.2</a></strong> (2021-10-26):<br />  * [fix] for #39; </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now works correctly when iTerm's "Exclude from Dock and ⌘-Tab Application Switcher" preference is enabled, albeit without support for </code>-g<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> and </code>-G<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, for technical reasons.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.7.0...v0.7.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.7.1</a></strong> (2021-04-06):<br />  * [fix] Fix for #13: </code>-g<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> and </code>-G<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now work in macOS Big Sur too.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.6.1...v0.7.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.7.0</a></strong> (2020-08-24):<br />  * [enhancement] Thanks to <a href="https://github.com/ksvirsky" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">@ksvirsky</a>, </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> is now also available on Linux, assuming </code>gnome-terminal<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> is available.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.6.0...v0.6.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.6.1</a></strong> (2017-11-08):<br />  * [fix] macOS 10.13 (High Sierra compatibility), which makes </code>-G<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> work again.<br />  * [installation] Homebrew formula added (added post-release, on 2019-12-22).</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.5.1...v0.5.2" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.6.0</a></strong> (2017-06-21):<br />  * [enhancement] </code>-d ''<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now prevents </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> from implicitly changing to what<br />    it thinks the working directory should be; useful for creating tabs/windows<br />    that set their own working directory.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.5.0...v0.5.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.5.1</a></strong> (2017-03-23):<br />  * [doc] Sample command fixed.<br />  * [dev] Reliability of tests improved.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.4.0...v0.5.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.5.0</a></strong> (2016-10-01):<br />  * [new feature] </code>-q<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now allows clearing the "screen" of the new tab after<br />     opening using </code>clear<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, assuming any command (list) passed succeeded.<br />  * [enhancement] A quoted multi-command shell command string can now be <br />    specified as a single - and only - operand, without having to precede with<br />    an explicit </code>eval<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> command. <br />  * [behavior change] If no custom title is specified with </code>-t <title><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, no<br />    attempt is made anymore to auto-derive a meaningful tab title from the<br />    shell command specified, as there is no heuristic that works well in all<br />    cases.<br />  * [fix] <a href="https://github.com/mklement0/ttab/issues/7" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">Issue #7</a>: iTerm2<br />    now also preserves the current working dir. when opening a new tab in the <br />    current window.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.3.1...v0.4.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.4.0</a></strong> (2016-09-13):<br />  * [enhancement] </code>-a Terminal|iTerm2<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now allows specifying the target Terminal<br />    application, which is useful for launching </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> from non-terminal applications<br />    such as <a href="http://alfredapp.com" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">Alfred</a>.<br />  * [fix] Specifying a syntactically invalid shell command to execute in the<br />    new tab now causes </code>ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> to report a nonzero exit code.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.3.0...v0.3.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.3.1</a></strong> (2016-06-03):<br />  * [enhancement] Support for iTerm2 v3 added (whose AppleScript syntax changed fundamentally)<br />  * [enhancement] Setting a tab title is now also supported in iTerm2 v2.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.2.1...v0.3.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.3.0</a></strong> (2016-05-04):<br />  * [enhancement] Experimental support for iTerm2 (</code>iTerm.app<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">) added.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.2.0...v0.2.1" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.2.1</a></strong> (2015-09-15):<br />  * [dev] Makefile improvements; various other behind-the-scenes tweaks.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.1.8...v0.2.0" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.2.0</a></strong> (2015-09-14):<br />  * [enhancement] You can now use embedded (escaped, if necessary) double-quotes inside a multi-command string passed via </code>eval<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">.<br />  * [doc] If installed via the npm registry, a man page is now installed (view with </code>man ttab<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">); if installed manually, </code>ttab --man<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><br />    shows a plain-text version. </code>ttab -h<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> now only prints concise, single-page usage information.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.1.7...v0.1.8" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.1.8</a></strong> (2015-09-11):<br />  * [doc] Incorrect new-window option corrected in examples.<br />  * [doc, dev] Read-me improved together with the Makefile to turn off syntax highlighting for the CLI help chapter.</p><p class="my-3">* <strong><a href="https://github.com/mklement0/ttab/compare/v0.1.6...v0.1.7" class="text-primary hover:underline" target="_blank" rel="noopener noreferrer">v0.1.7</a></strong> (2015-06-26):<br />  * [doc] Read-me: npm badge changed to shields.io; license badge added.<br />  * [dev] Makefile updated.</p><p class="my-3">* <strong>v0.1.6</strong> (2015-06-01):<br />  * [doc] Read-me improvements; typo in CLI usage help fixed.</p><p class="my-3">* <strong>v0.1.5</strong> (2015-06-01):<br />  * [doc] Improved CLI usage help.</p><p class="my-3">* <strong>v0.1.4</strong> (2015-06-01):<br />  * [doc] Improved CLI usage help; keywords added to </code>package.json<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">.<br />  * [dev] </code>make browse` now opens the GitHub repo in the default browser.</p><p class="my-3">* <strong>v0.1.3</strong> (2015-06-01):<br />  * [fix] The -g and -G options again correctly do not activate Terminal.app when creating the desired tab.<br />  * [enhancement] Option parsing now accepts option-arguments directly attached to the option.<br />  * [dev] Tests added.</p><p class="my-3">* <strong>v0.1.2</strong> (2015-06-01):<br />  * [doc] Manual-installation link and instructions fixed; examples fixed.</p><p class="my-3">* <strong>v0.1.1</strong> (2015-06-01):<br />  * [doc] README.md improved with respect to manual installation instructions.</p><p class="my-3">* <strong>v0.1.0</strong> (2015-06-01):<br />  * Initial release.<br /></p></div><div class="flex justify-center absolute inset-x-0 bottom-0 bg-gradient-to-t from-background via-background to-transparent pb-4 pt-16"><button data-slot="button" class="inline-flex items-center justify-center whitespace-nowrap text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50 h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down mr-1 h-4 w-4"><path d="m6 9 6 6 6-6"></path></svg>Show more</button></div></div></div><template id="P:3"></template><template id="P:4"></template></div></div></div><script>self.__next_f.push([1,"2b:[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}]\n2c:[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^4.0.10\"}]\n2d:[\"$\",\"$L5\",\"marked-man\",{\"href\":\"/package/marked-man\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"marked-man\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^0.7.0\"}]]}]\n2e:[\"$\",\"$L5\",\"replace\",{\"href\":\"/package/replace\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"replace\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^1.2.0\"}]]}]\n2f:[\"$\",\"$L5\",\"semver\",{\"href\":\"/package/semver\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"semver\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^4.2.0\"}]]}]\n30:[\"$\",\"$L5\",\"tap\",{\"href\":\"/package/tap\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"tap\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^18.5.1\"}]]}]\n31:[\"$\",\"$L5\",\"urchin\",{\"href\":\"/package/urchin\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-"])</script><script>self.__next_f.push([1,"100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"urchin\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^0.0.5\"}]]}]\n"])</script><div hidden id="S:3"><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-dependencies" hidden="" id="radix-_R_aav5ubrb_-content-dependencies" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div></div><script>$RS=function(a,b){a=document.getElementById(a);b=document.getElementById(b);for(a.parentNode.removeChild(a);a.firstChild;)b.parentNode.insertBefore(a.firstChild,b);b.parentNode.removeChild(b)};$RS("S:3","P:3")</script><div hidden id="S:4"><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-versions" hidden="" id="radix-_R_aav5ubrb_-content-versions" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div></div><script>$RS("S:4","P:4")</script><script>$RC("B:1","S:1")</script></body></html>