Quick Start

Your first session

Log in — Connect your device to your taiku account.
Terminal window
```
taiku login
```
This opens a browser window for OAuth authentication. Once complete, your credentials are saved at ~/.config/taiku/credentials.
Start a session — Launch a collaborative terminal.
Terminal window
```
taiku
```
By default, this opens the desktop app. Use --no-app for CLI-only mode.
Share the link — Copy the session URL and share it with collaborators. They can join directly in their browser — no install required.

taiku has two modes of operation:

Desktop app — A native Tauri application that wraps the web UI. Runs in the background, keeps your device registered, and lets you start remote sessions from the dashboard. Adds native menus and keyboard shortcuts. This is the default when you run taiku.
CLI-only — Lightweight mode with taiku --no-app. Prints the session URL to your terminal and stays in the foreground. Best for headless servers or quick one-off sessions.

Both modes create the same encrypted session. The desktop app just adds a persistent UI layer on top.

Flag	Description
`--no-app`	CLI-only mode
`--tunnel 3000`	Expose a local port as an HTTP tunnel
`--enable-readers`	Generate separate read-only and write URLs
`--shell /bin/zsh`	Specify which shell to use

See the full CLI reference for all options.