# TUI Control The control channel a running terminal UI exposes: append or submit a prompt, open a dialog, execute a command, show a toast, and the request/response pair behind remote control. Playground Send these requests to your own running server. Values stay in this browser. Not connected Base URL Directory _optional_ Bearer token _optional_ How this works Start a server with `nikcli serve --hostname 127.0.0.1 --port 4096`. Requests go straight from this page to that address — the browser allows it because loopback counts as a secure origin, and the server allows it because `nikcli-ai.dev` is in its CORS allowlist. To try things without touching your real sessions or config, start the server with `NIKCLI_TEST_HOME` pointed at a throwaway directory — see [the guided tour](/docs/guides/api-tour). ## Operations 14 endpoints, generated from the server's own [OpenAPI document](/docs/api). Every path also accepts the `directory` and `workspace` query parameters that select which instance handles the request.
post/tui/append-prompttui.appendPrompt
post/tui/open-helptui.openHelp
post/tui/open-sessionstui.openSessions
post/tui/open-themestui.openThemes
post/tui/open-modelstui.openModels
post/tui/submit-prompttui.submitPrompt
post/tui/clear-prompttui.clearPrompt
post/tui/execute-commandtui.executeCommand
post/tui/show-toasttui.showToast
post/tui/publishtui.publish
post/tui/select-sessiontui.selectSession
get/tui/configtui.config
get/tui/control/nexttui.control.next
post/tui/control/responsetui.control.response
### Append Prompt post /tui/append-prompt [#](#op-post-tui-append-prompt) `tui.appendPrompt` Parameters | Name | In | Type | Required | | --- | --- | --- | --- | | directory | query | string | optional | | workspace | query | string | optional | Request body · required · application/json { text: string } Responses 200 TuiBooleanResult application/json boolean 400 TuiValidationError application/json { data: unknown error: unknown success: false } Example response from schema false Generated from the response schema — field values are placeholders, the shape is real. SDK example tui.appendPrompt ts 1 2 3 4 5 6 ``` import { createNikcliClient } from "@nikcli-ai/sdk/httpapi" const client = createNikcliClient() await client.tui.appendPrompt({ ... }) ``` Try it directory _query_ workspace _query_ Request body _application/json_ { "text": "" } --- Source: https://nikcli-ai.dev/docs/api/tui