# Site Manager — Liu Terminal

> Liu Terminal Site Manager. Register local project folders, start/stop dev servers from one panel, watch live logs, and preview instantly in-app.

URL: https://liu.software/docs/sites/  
Language: en  
Updated: 2026-10-17

Register up to 32 local project folders as sites, start/stop their dev servers from one panel, stream logs, and open the in-app browser on the detected port.

## Open Site Manager

- **Cmd+Shift+S** — default keybinding (Site Manager action)
- Command Palette: Site Manager, Start Site, Restart Site, Stop All Sites

## Register a site

Each site stores a display name, filesystem path, start command (for example npm run dev), and optional port hint (0 = auto-detect from process output). Definitions persist as flat site\_\<index\>\_\* keys in config.json; runtime process state is never written.

## Persistence and port detection

The config file uses a flat representation, for example:

```
{
  "site_count": 1,
  "site_0_name": "My app",
  "site_0_path": "/path/to/app",
  "site_0_command": "npm run dev",
  "site_0_port": 0
}
```

A non-zero port is a hint. Liu prefers a port detected from process output, then falls back to the hint. Output may be split across PTY reads; if neither value is available, the browser action stays unavailable.

## Run & logs

Start, stop, or restart from the overlay. Live stdout/stderr is buffered with ANSI color preserved so you can debug crash loops without leaving Liu. Status shows starting / online / offline as the supervisor tracks the process and port.

## Preview in-app

When a site is online, open the in-app browser on its URL (palette Browser or split variants). Connection failures can offer Ask Agent to feed error context into your coding agent. Element picker (Select Element) grabs DOM nodes for prompt context.

[Next In-App Browser →](https://liu.software/docs/browser.md)