noctty README

README проекта с github.com/amanthanvi/noctty. Одним файлом markdown: README.md.

Noctty

A native Windows terminal built on Ghostty's terminal core.
Tabs, splits, and session restore · Win32 and OpenGL · No telemetry

Download · Website · Getting started · Windows guide · Status · Contributing

Formerly winghostty. Renamed in August 2026 after a trademark request from the Ghostty team.

Noctty with two tabs and a vertical split, Dracula theme


Noctty is a Windows terminal that pairs the terminal core from Ghostty with a native Win32 app written for this fork.

Noctty is young and has one maintainer. It installs alongside your current terminal and does not replace it, so you can try both side by side. It runs on Windows only; macOS and Linux are not planned. See docs/status.md for what works and what is still experimental, and the capability matrix for a feature-by-feature comparison with upstream Ghostty.

Install

Requirements: Windows 10 version 1809 (build 17763) or later, or Windows 11, on x64 or ARM64. The default renderer needs a GPU driver that supports OpenGL 4.3 or later.

The latest release is noctty 1.3.137, published 2026-11-09.

With WinGet

winget install --id AmanThanvi.noctty -e

With Scoop

scoop bucket add noctty https://github.com/amanthanvi/scoop-noctty
scoop install noctty/noctty

With Chocolatey

choco install noctty

chocolatey.org reviews each version before listing it, so it can trail the other channels after a release.

Direct download

The installer adds a Start menu entry, an "Open noctty here" item to Explorer's right-click menu, and an uninstaller. The portable ZIP runs from any folder without installing.

Your PC Installer Portable
x64 (Intel and AMD) noctty-1.3.137-windows-x64-setup.exe noctty-1.3.137-windows-x64-portable.zip
ARM64 (Windows on Arm PCs) noctty-1.3.137-windows-arm64-setup.exe noctty-1.3.137-windows-arm64-portable.zip

[!NOTE] Releases are signed with a self-signed certificate, so Windows SmartScreen shows "Windows protected your PC" when you first run one. Check the download first, then click More info, then Run anyway. Hash the file and compare the result with its line in SHA256SUMS-windows-x64.txt or SHA256SUMS-windows-arm64.txt from the same release:

Get-FileHash .\noctty-1.3.137-windows-x64-setup.exe -Algorithm SHA256

A matching checksum shows the file arrived intact, not who published it. docs/verify-release.md covers the stronger provenance and signature checks.

Each release also includes signed manifests of the portable ZIP contents (noctty-1.3.137-windows-x64-portable.manifest.ps1 and noctty-1.3.137-windows-arm64-portable.manifest.ps1) and SHA256SUMS.txt, an alias of the x64 checksum file kept for older auto-update clients. Newer releases also publish a symbols zip per architecture, noctty-<version>-windows-<arch>-symbols.zip, for reading crash dumps; docs/windows.md says which releases have it.

Scoop puts noctty on your PATH. WinGet and Chocolatey run the installer, and neither the installer nor the portable ZIP adds it. To run the noctty commands in this README, add the install folder to PATH or run .\noctty.com from that folder.

For portable mode and uninstalling, see docs/getting-started.md. Switching terminals? There are guides for moving from Windows Terminal and from Git Bash/mintty.

Getting started

On first launch, Noctty writes a config template to %LOCALAPPDATA%\noctty\config.ghostty. Every default is built into the app, so the template sets no options: add only what you want to change. You can also press Ctrl+, to open the Settings window.

font-family = JetBrains Mono
font-size = 12
theme = Dracula

Save the file, then press Ctrl+Shift+, to reload. Run noctty +list-themes to browse the bundled themes.

A few keys to start with:

Action Keys
Copy / paste Ctrl+Shift+C / Ctrl+Shift+V
New tab Ctrl+Shift+T
Split right Ctrl+Shift+\
Split down Ctrl+Shift+E
Move between panes Alt+arrow keys
Command palette Ctrl+Shift+P
Search Ctrl+Shift+F
Settings Ctrl+,
Reload config Ctrl+Shift+,

The full list, and how to rebind keys, is in docs/getting-started.md. To drive Noctty from scripts and the command line, see docs/automation.md.

Privacy and updates

The privacy policy describes what Noctty stores on your PC, the connections it makes, and how to remove your data. More detail on updates is in docs/windows.md.

Troubleshooting

See docs/windows.md for more.

Build from source

You need:

git clone https://github.com/amanthanvi/noctty.git
cd noctty
zig build -Demit-exe=true

The app is built to zig-out\bin\noctty.exe, beside Microsoft's pinned ConPTY pair, which the first build downloads. Building has no Windows version requirement of its own, but running the result needs Windows 10 1809 or later. HACKING.md covers the dev shell, offline builds and tests, and PACKAGING.md covers building the installer and portable ZIP.

Relationship to Ghostty

Noctty is a fork of Ghostty. It takes in upstream changes in planned merge windows, normally after each Ghostty release; see the upstream merge policy, and docs/status.md for the Ghostty version it is currently based on. It shares Ghostty's terminal core, fonts, renderer, input handling, config, shell integration, and libghostty-vt. The Win32 app, the updater, and the Windows packaging were written for this fork, and the macOS and GTK apps have been removed. When Windows conventions and upstream behavior disagree, Noctty follows Windows.

Noctty is an independent project and is not affiliated with Ghostty.

Contributing

Bug reports and focused pull requests are welcome. Please read CONTRIBUTING.md and AI_POLICY.md first.

Pull requests are reviewed automatically by Greptile.

Greptile: The War on Bugs

License

MIT, the same as Ghostty. Copyright © 2024 Mitchell Hashimoto, Ghostty contributors. Changes made in this fork are released under the same license. See LICENSE.

noctty (amanthanvi/noctty)

Ищем в базе…

564 ·GitHub
Что это такое?Noctty — это нативный терминал для Windows, который сочетает ядро терминала из Ghostty с отдельным интерфейсом на Win32. Раньше он назывался winghostty.
Это форк существующего терминала или создано с нуля?Это форк Ghostty: ядро терминала, шрифты, рендерер, обработка ввода, конфигурация и интеграция с оболочкой общие с Ghostty, а приложение на Win32, модуль обновлений и упаковка для Windows созданы специально для этого форка.
Что нужно моему компьютеру, чтобы его запустить?Windows 10 сборки 17763 и новее или Windows 11 на x64 или ARM64, а также драйвер видеокарты с поддержкой OpenGL 4.3 для рендерера по умолчанию. Если поддержки нет, используется рендерер на Direct3D 11.
Есть ли подводные камни, прежде чем перейти на него насовсем?Это молодой проект с одним сопровождающим, поддержка macOS и Linux не планируется, а восстановление сеанса возвращает окна, вкладки и рабочие каталоги, но не программы, которые были запущены.
Отправляет ли он куда-нибудь мои данные?Телеметрия не собирается. Единственный исходящий трафик — проверка обновлений на GitHub Releases, а отчёты о сбоях остаются на вашем компьютере.
Что будет, если моя видеокарта не поддерживает OpenGL 4.3?Noctty автоматически переключится на бета-рендерер Direct3D 11 (сначала аппаратный D3D11, затем программный резерв WARP от Microsoft) и покажет уведомление. Пользовательские шейдеры, фоновые изображения и изображения Kitty по-прежнему требуют OpenGL.
Может ли он сообщить, когда кодовому агенту нужно моё внимание?Да. Агенты и инструменты могут передавать статус с помощью кода OSC 7501, отмечая вкладку как «в работе», «заблокирована», «готова» или «ошибка». Noctty уведомит вас, когда фоновой вкладке понадобится ваше внимание.
Почему его переименовали из winghostty в noctty?Проект переименовали в noctty в августе 2026 года. Раньше он назывался winghostty.
Мои существующие темы и конфигурация Ghostty будут работать?Да. Большинство параметров конфигурации и тем Ghostty работают без изменений, поскольку Noctty использует общую с Ghostty систему конфигурации и ядро терминала.
Автор
amanthanvi
Размер
298.6 MB
Звёзды
564
Возраст
7 мес
Коммиты · 90 дней