Interactive TUI
Runsorat with no flags to enter the interactive menu:
| Option | Description |
|---|---|
| Start Server | Run the server in the foreground terminal |
| Start Daemon | Launch the server as a background process |
| Stop Daemon | Stop the background server |
| Status | Display server info (uptime, model, session count) |
| Logs | View server logs in a scrollable TUI viewer |
| Chat | Interactive chat with the agent |
| Providers | Manage LLM providers |
| Skills | Manage installed skills |
| Cron Jobs | Manage scheduled jobs |
| Reset Data | Delete all data in ~/.sorat/ |
j/k, press Enter to select, and q or Esc to go back.
CLI flags
| Flag | Description |
|---|---|
--dev | Dev mode — proxies frontend requests to localhost:3000 |
--foreground | Run server in foreground (no interactive menu) |
--daemon | Run server as a background process |
--version, -v | Print version |
--help, -h | Print usage |
Chat mode
The chat TUI provides a split-pane interface:- Top pane: scrollable message history
- Bottom pane: text input area
| Key | Action |
|---|---|
| Ctrl+D | Send message |
| Esc | Quit chat |
| Up/Down | Scroll message history |
[tool: tool_name].
Log viewer
The log viewer displays the last 200 lines of the current day’s log file with auto-refresh every 2 seconds.| Key | Action |
|---|---|
| Up/Down | Scroll |
| q / Esc | Exit |
Provider management
The Providers submenu:| Option | Description |
|---|---|
| List All | Show all providers with endpoint, auth method, and active status |
| Add Provider | Interactive form: name, API endpoint, API key, model name |
| Remove Provider | Select and confirm deletion |
| Set Active | Choose which provider and model to use |
Skills management
The Skills submenu:| Option | Description |
|---|---|
| List All | Show installed skills with enabled status |
| Install Skill | Install from a GitHub repo path or ClawHub slug |
| Remove Skill | Uninstall a skill by name |
Cron management
The Cron Jobs submenu:| Option | Description |
|---|---|
| List Jobs | Show all jobs with status, schedule, and last run time |
| Enable Job | Resume a disabled job |
| Disable Job | Pause an active job |
| Remove Job | Delete a job permanently |
Status display
The Status command shows:- Whether the server is running
- PID and uptime
- Active model name
- Number of stored sessions
- Server URL