Namu

Namu is an AI native terminal app for macOS built on Ghostty. It combines split-pane terminal workflows, SSH remote workspace orchestration, browser automation, a JSON-RPC socket API, a scriptable CLI, and deep agent hook integrations.

Namu ships outbound alert routing, SSH remote workspaces with daemon provisioning, agent hooks for Claude Code and Codex, and an authenticated relay for remote command forwarding.

Features

Ghostty Terminal

GPU-accelerated rendering, low-latency input, Unicode support, CJK IME, dictation, middle-click paste, copy mode, image transfer, and shell integration.

Workspaces and Splits

Tabbed workspaces with arbitrary horizontal and vertical pane trees powered by NamuSplit. Surface reorder, drag-to-split, move across workspaces, pane swap, and break-to-new-workspace.

SSH Remote Workspaces

namu ssh user@host provisions the Go daemon binary, sets up an HMAC-SHA256 relay, tunnels browser traffic via SOCKS5/HTTP CONNECT, and keeps the session alive with exponential-backoff reconnection.

JSON-RPC Socket API

Full programmatic control over workspaces, panes, surfaces, sidebar status/progress/log, notifications, browser panels, windows, and debug commands.

CLI and Hooks

The namu CLI supports short ref IDs, --no-focus, --id-format, socket password auth, 37 tmux-compat commands, Claude hooks, and Codex hooks.

Notification System

Status tracking, progress bars, and structured logging APIs feed colored pills into the sidebar. Menu bar badge, 16 built-in sounds, desktop notifications with focus suppression.

Embedded Browser

84 automation commands covering navigation, DOM, JavaScript, tabs, history, profiles, cookies, and screenshots. HTTPS insecure bypass, find-in-page restoration, browser theme mode, and network tracing.

Agent Integrations

10 Claude Code hook types, Codex hook support, agent PID tracking per surface, per-workspace port allocation, and session lockfile store with 7-day TTL.

Alert Routing

Rule-based alert detection with 4 trigger types and outbound Slack, Telegram, Discord, and generic webhook delivery.

Window Management

Full window list/create/focus/close/current APIs. 30+ debug commands including layout tree, window screenshot, panel snapshot with pixel diff, flash counters, and render stats.

Security

SSRF blocking for cloud metadata endpoints, CryptoKit constant-time HMAC verification, path traversal protection on manifest fields, and response size caps on relay and proxy.

Quick Links