TUI

TUI is DotCraft's Rust-native terminal interface for users who want a full interaction experience in the terminal. It connects through the AppServer Wire Protocol and reuses the same workspace, session, and approval capabilities.

Build

cd tui
cargo build --release

Outputs land in target/release/. On Windows the binary is dotcraft-tui.exe.

How to Start

Hub-Managed Local Mode (default)

From a project directory:

dotcraft-tui

TUI starts or discovers DotCraft Hub, asks Hub to ensure the workspace AppServer, then connects to the returned WebSocket endpoint.

Specify Workspace or Binary

dotcraft-tui --workspace /path/to/project
dotcraft-tui --server-bin /usr/local/bin/dotcraft
DOTCRAFT_BIN=/usr/local/bin/dotcraft dotcraft-tui

Remote Mode

dotcraft app-server --listen ws://127.0.0.1:9100
dotcraft-tui --remote ws://127.0.0.1:9100/ws

With authentication:

dotcraft-tui --remote ws://server:9100/ws --token my-secret

Command-Line Arguments

Argument	Description
--workspace	Workspace directory
--server-bin	dotcraft binary used to start Hub
--remote	Connect to an existing WebSocket AppServer
--token	Remote AppServer auth token
`--lang zh	en`
--theme	Custom TOML theme

Common Slash Commands

/new, /model, /provider, /clear, /quit.

• /provider lists configured personal providers
• /provider <id> selects the workspace provider
• Provider creation, editing, testing, and deletion live in Desktop or any AppServer-capable client

For full key bindings and theme details, see tui/README.md.

Advanced

• Default mode is Hub-managed local mode; remote mode targets explicitly hosted AppServers.
• Enable debug logs: DOTCRAFT_TUI_LOG=debug dotcraft-tui 2>tui.log
• Enable system clipboard: cargo build --release --features clipboard

Troubleshooting

TUI cannot find dotcraft

Put dotcraft next to dotcraft-tui or on PATH, or use --server-bin / DOTCRAFT_BIN to specify the path.

Remote connection fails

Confirm AppServer is running in WebSocket mode and the URL includes /ws. Authenticated services also need a matching token.

Terminal looks wrong

Use a modern terminal with Unicode and color support; make sure the terminal size is large enough. Test with the default theme first.

Related

• Desktop
• AppServer Mode
• Settings Lifecycle