Even Terminal

even-terminal is designed to be used with the Even App.

Install

npm install -g @evenrealities/even-terminal

Quick Start

even-terminal

By default the server starts on http://localhost:3456.

Useful startup options:

even-terminal --cwd /path/to/project
even-terminal --port 8080
even-terminal --token mytoken123
even-terminal --name my-laptop
even-terminal --provider codex
even-terminal --expose pinggy
even-terminal --expose bore

CLI

even-terminal [command] [options]

Commands:
  even-terminal start
  even-terminal complete <shell>

Local network options:
  --tailscale
  -i, --interface, --if <name>

Quick public expose options:
  --expose <provider>   Quick public expose provider (`pinggy`, `bore`)

Options:
  -p, --port <n>
  -t, --token <str>
  -n, --name <str>
  -d, --cwd <path>
  --provider <name>   claude or codex
  --log-file [path]
  --verbose
  -h, --help
  -v, --version

Examples:
  even-terminal
  even-terminal -p 8080
  even-terminal -t mytoken123
  even-terminal --expose pinggy

Quick public expose helpers are intended for simple temporary sharing, not long-term use. For stable setups, prefer a proper network path such as Tailscale or a production tunnel configuration.

Current quick expose providers:

• pinggy via ssh -p 443 -R0:localhost:<port> a.pinggy.io
• bore via bore local <port> --to bore.pub

Shell completion (example usage):

even-terminal complete zsh
even-terminal complete bash
even-terminal complete fish
even-terminal complete powershell

Each form prints the completion script for that shell.

Flow

1. Start the server with even-terminal
2. Scan the QRCode or configure in even app
3. ...