Why I Built Nathstar: A Local-First, 120Hz Native macOS Terminal for Projects, Live Ops & Private AI

Description and use

Nathstar is a local‑first macOS terminal that unifies project workspaces, silent env sync, live port management, native command editing, blast‑radius safety, and optional local AI, eliminating the trade‑offs of existing terminals.

Problem

Developers on macOS face a trade‑off between fast GPU terminals that treat windows as stateless grids and cloud‑tethered terminals that require accounts and telemetry, making it hard to manage multi‑service projects, environment variables, and live ports.

Outcome

Nathstar delivers a local‑first, zero‑telemetry macOS terminal that unifies project persistence, silent env sync, live port management, native command editing, blast‑radius safety, and optional local AI, addressing the shortcomings of existing terminals.

Workflow

• Create or open a Project Workspace in Nathstar
• Split panes and run services
• Edit .env variables in the Manifest panel and click Set & Apply to inject them silently
• Use the Live Ports & Processes tab to identify and manage ports
• Edit long commands with click‑to‑cursor or pull to composer (⌘E)
• Run commands with blast‑radius safety checks
• Enable local Ollama or BYOK cloud models for AI assistance

Evidence

Minimalist GPU Emulators (Ghostty, Alacritty, Kitty): Blazingly fast and standards‑compliant, but they treat every window as an isolated, stateless text grid.

Source

Cloud‑Tethered "Block" Terminals (Warp): Great input editing and AI features, but built around cloud accounts, telemetry by default, and metered subscriptions—while replacing standard terminal buffers with custom UI layers that can fight full‑screen TUIs like nvim, lazygit, or htop.

Source

When Nathstar spawns zsh, it uses a lightweight, transparent ZDOTDIR shim that sources your real .zshenv and .zshrc untouched and installs a TRAPUSR1 signal handler.

Source

Every 3 seconds (while open), LivePortScanner inspects listening TCP sockets (lsof) and walks the parent PID (ps) tree up to the root shellPid of every Nathstar pane.

Source

Press ⌘E at any time to pull your active terminal line into the bottom multi‑line macOS text editor. Edit with standard macOS selection and undo, use Tab ⇥ IDE‑style autocomplete, and press ⇧⏎ to insert it back into the prompt or ⌘⏎ to run it.

Source

Nathstar’s AI layer is 100% opt‑in and bring‑your‑own‑model: Zero‑Config Local Ollama automatically queries http://127.0.0.1:11434/api/tags to discover your locally installed Ollama models for completely offline, private inference.

Source