AI Terminal

AI Terminal is a web workspace for local and remote Mac tmux sessions. It keeps a Codex-like project and conversation list on the left, and uses xterm.js on the right to attach to tmux.

Run

npm run dev

The web app opens at http://localhost:5174, with the API and terminal WebSocket on port 4317.

Local Package

Build a local installable package:

npm run package:local

The package is written to release/biang-ai-terminal-<version>.tgz.

Install it on another Mac:

npm install -g ./biang-ai-terminal-<version>.tgz
cd /path/to/workspace
ai-terminal

Update a running workspace without manually stopping it:

ai-terminal update

Open http://localhost:4317. Runtime state is stored in ./data/store.json for the directory where ai-terminal is launched.

Useful options:

AI_TERMINAL_SERVER_PORT=4321 ai-terminal
AI_TERMINAL_DATA_DIR="$HOME/.ai-terminal" ai-terminal
AI_TERMINAL_WORKSPACE_ROOT="/path/to/workspace" ai-terminal

Requirements for the target Mac:

• Node.js 20+
• tmux
• Xcode Command Line Tools if node-pty needs to compile during install

npm Install

Install from npm:

npm install -g @biang/ai-terminal
cd /path/to/workspace
ai-terminal

Remote Mac

Add a remote connection from the connection drawer. The server connects with SSH keys or an existing SSH agent, then runs:

tmux new-session -A -s <conversation-session>

The browser never receives SSH credentials. Terminal data flows only through the local Node server.

Pairing Remote Macs

For a UI flow, open the connection drawer and use "无感配对".

For a headless flow, create a request code on the client:

ai-terminal pair offer --name "My Mac"

On the target Mac, allow that request and generate a connection code:

ai-terminal pair accept '<request-code>' --name "Mac Studio" --host 192.168.1.8 --cwd /path/to/workspace

Back on the client, import the connection:

ai-terminal pair import '<connection-code>' --name "Mac Studio"

The pairing flow creates a local ~/.ssh/ai_terminal_ed25519 key on the client and appends its public key to the target Mac's ~/.ssh/authorized_keys. It does not put private keys or passwords into pairing codes. The target Mac still needs SSH/Remote Login enabled.

Notes

• Install tmux on local and remote machines.
• The Claude button sends claude plus Enter into the active tmux terminal.
• Runtime state is stored in data/store.json.