VibeTerm 2

@swarmclawai/vibeterm@0.2.2 is a desktop-first terminal workspace built with Tauri, React, and xterm.js.

It supports:

• desktop mode by default
• optional web/remote mode
• launcher-aware terminal creation
• startup-directory aware session creation
• pinned and recent project directories
• theme previews, extra bundled themes, and local custom themes

Install

npm install -g @swarmclawai/vibeterm

Desktop mode builds and runs through Tauri on the local machine, so Rust/Cargo and standard Tauri desktop prerequisites still need to be installed.

Start

Desktop mode is the default:

vibeterm

You can also start it explicitly:

vibeterm desktop

Or launch with a specific startup directory already selected:

vibeterm ~/Dev/my-project
vibeterm desktop ~/Dev/my-project
vibeterm --cwd ~/Dev/my-project

Web Mode

Passwordless web mode:

vibeterm web

Password-protected web mode:

vibeterm web --password

When password mode is enabled, the generated token is printed in the terminal output.

Local Development

Desktop app:

npm run desktop:dev

Web mode without a password:

npm run web:dev

Web mode with a generated password:

npm run web:dev:password

Production build:

npm run build

Runtime Modes

Desktop mode:

• native Tauri shell
• local launcher detection
• optional launcher bypass that starts the default shell immediately

Web mode:

• browser client with remote PTY backend
• starts a default shell automatically

Launcher

The launcher supports:

• quick start with the default shell
• pinned directories
• recent directories
• typed path selection
• machine-wide directory search on macOS
• provider-aware session launch and resume
• shell selection when multiple local shells are detected
• a settings toggle to disable the launcher and auto-start the default shell

In smaller panes, the launcher automatically switches to a compact quick-launch layout.

Themes

VibeTerm 2 includes a broader bundled theme set and supports local custom themes.

• hover a theme in the top bar to preview it
• click to apply it
• create a custom copy from Settings
• edit accent/background/foreground/glow colors
• delete custom themes from Settings

Custom themes are stored locally on the machine.