feat(tui): add local embedded TUI mode with terminal/chat aliases by fuller-stack-dev · Pull Request #66767 · openclaw/openclaw

fuller-stack-dev · 2026-04-14T19:34:41Z

Summary

Adds a gateway-free local TUI path so users can run OpenClaw in their terminal without needing a running gateway process.

openclaw tui --local flag for local embedded mode (no gateway required)
openclaw terminal / openclaw chat aliases that imply --local
TuiBackend interface abstraction (tui-backend.ts) with EmbeddedTuiBackend implementation driving the agent loop in-process via agentCommandFromIngress
/auth slash command with TUI suspend/resume flow and codex login delegation for OpenAI Codex provider (avoids prolite plan issue from OpenClaw's OAuth originator)
Default model display fallback on startup
Local-aware status text ("local ready" instead of "connected") and console log suppression
Concise auth error hints, raw HTML 403 suppression in lifecycle handler messages
Onboarding hatch flow launches local TUI (no gateway required), Web UI option only shown when gateway is reachable
Commander .alias() bug fix in run-main.ts (.aliases().includes() check)

Files Changed

Area	Files	What
TUI backend	`tui-backend.ts`, `embedded-backend.ts`	New interface + local implementation
TUI core	`tui.ts`, `tui-types.ts`, `commands.ts`	Local mode, log suppression, /auth flow
TUI handlers	`tui-command-handlers.ts`, `tui-event-handlers.ts`, `tui-session-actions.ts`	Backend abstraction, auth hints
CLI	`tui-cli.ts`, `run-main.ts`, `register.subclis-core.ts`, `subcli-descriptors.ts`	Aliases, --local flag, alias bug fix
Agents	`model-selection-display.ts`, `pi-embedded-subscribe.handlers.lifecycle.ts`	Default model fallback, 403 suppression
Wizard	`setup.finalize.ts`	Hatch launches local TUI
Gateway	`gateway-chat.ts`	Implements `TuiBackend`, shared types extracted

Testing

145 tests across 11 test files, all passing
pnpm build clean
pnpm check (lint/format/cycles/tsgo) clean on touched files
Pre-commit hook passed (oxlint 0 errors, 0 import cycles)

greptile-apps · 2026-04-14T19:38:58Z

Greptile Summary

This PR adds a gateway-free embedded TUI mode (openclaw tui --local, openclaw terminal, openclaw chat) backed by a clean TuiBackend interface abstraction. It also fixes a Commander.js alias recognition bug in run-main.ts (.aliases().includes(primary)) and wires the onboarding hatch flow to launch the TUI locally without requiring a running gateway.

The implementation is well-structured: the EmbeddedTuiBackend correctly uses a finalSent guard to prevent double-emit from the concurrent handleAgentEvent lifecycle path and the post-agentCommandFromIngress path in runTurn, and stop() safely aborts in-flight runs before clearing the run map. All remaining findings are P2.

Confidence Score: 5/5

Safe to merge — no P0/P1 issues found; all comments are style-level suggestions.

The core concurrency correctness (finalSent guard, abort-on-stop, run-map cleanup) is solid and well-tested (145 tests). The Commander alias fix is correct. The prior P1 concern about broad process.argv scanning has been addressed. Remaining comments are P2 (an unused required field in a context type, and a type assertion in listModels that could expose undefined names).

src/tui/embedded-backend.ts (listModels type assertion) and src/tui/tui-command-handlers.ts (noteLocalRunId required but unused).

Prompt To Fix All With AI

This is a comment left during a code review.
Path: src/tui/tui-command-handlers.ts
Line: 29-53

Comment:
**`noteLocalRunId` required in context but never used**

`noteLocalRunId` is declared as a required field in `CommandHandlerContext` (no `?`) but is never destructured or referenced anywhere inside `createCommandHandlers`. The actual `noteLocalRunId` call happens in `createEventHandlers` via the `handleChatEvent` / `pendingOptimisticUserMessage` path — the command-handler context doesn't need it. Keeping it required silently forces callers to supply a value that is immediately discarded, and may mislead future readers into thinking it is used here.

```suggestion
  noteLocalRunId?: (runId: string) => void;
  noteLocalBtwRunId?: (runId: string) => void;
```

How can I resolve this? If you propose a fix, please make it concise.

---

This is a comment left during a code review.
Path: src/tui/embedded-backend.ts
Line: 346-355

Comment:
**Unchecked type assertion on catalog entries**

`allowedCatalog` and `catalog` are cast to `TuiModelChoice[]` without verifying the shape. `TuiModelChoice` requires `name: string` (non-optional), but the catalog entries from `loadGatewayModelCatalog` / `buildAllowedModelSet` may use `name?: string | undefined`. If any entry is missing `name`, callers that unconditionally read `model.name` (e.g. the model-selector label) will render `undefined`.

Consider using a mapping to ensure the shape, mirroring what `GatewayChatClient.listModels` returns from the wire:

```typescript
const entries = allowedCatalog.length > 0 ? allowedCatalog : catalog;
return entries.map((m) => ({
  id: m.id,
  name: m.name ?? m.id,
  provider: m.provider,
  contextWindow: m.contextWindow,
  reasoning: m.reasoning,
}));
```

How can I resolve this? If you propose a fix, please make it concise.

_{Reviews (2): Last reviewed commit: "TUI: fix alias detection, cross-platform..." | Re-trigger Greptile}

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 43a2fc94c1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

JSy-LodgeLink · 2026-04-14T20:17:10Z

@greptileai review again please

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6fdda81c21

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1fcadc8f60

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ff005edb26

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d682cbf3a6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

fuller-stack-dev · 2026-04-15T03:23:12Z

Also addressed the two summary-only review notes in 5af25f2957:

src/tui/tui-command-handlers.ts: noteLocalRunId is now optional since createCommandHandlers() does not use it.
src/tui/embedded-backend.ts: listModels() now maps catalog entries to a guaranteed TuiModelChoice shape and falls back to name ?? id instead of using an unchecked cast.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5af25f2957

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

fuller-stack-dev · 2026-04-15T03:46:40Z

Also fixed the current CI failures in 5993a99d9b:

synced the stale workflow files on this branch to the current upstream/main versions so security-fast no longer audits an outdated reusable workflow diff
fixed the merged-branch check failure by preserving allowPrivateNetwork through media-understanding provider request resolution and adding the missing request type field

Local verification on this branch now passes:

OPENCLAW_LOCAL_CHECK=0 pnpm check
pnpm build
pnpm test src/agents/pi-tools.before-tool-call.embedded-mode.test.ts src/tui/tui.test.ts src/media-understanding/runner.proxy.test.ts

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5993a99d9b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

fuller-stack-dev · 2026-04-15T06:54:11Z

Merged the latest upstream/main into feat/local-embedded-tui as b4e61bc7ab to resolve the remaining PR merge conflicts without force-pushing. The only hand-resolved conflict files were src/agents/pi-embedded-runner/run/attempt.prompt-helpers.ts and src/media-understanding/types.ts; the rest came from the base branch merge.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1cf689c6eb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e9acb355b0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@fuller-stack-dev

…nks @fuller-stack-dev)

obviyus

Verified the embedded local TUI approval path: approval-required plugin tools no longer get auto-approved when the Gateway approval route is unavailable, and the local TUI smoke runs without a Gateway.

Maintainer follow-up: restored embedded session resolution, added the Unreleased changelog entry, and fixed setup TUI relaunch so local: true becomes --local in the spawned process.

Local gate: targeted embedded/TUI/wizard tests, pnpm check, and pnpm build.

obviyus · 2026-04-22T04:39:17Z

Landed on main.

Landed source commit: 6d2acda
Merge commit: 276c000

Thanks @fuller-stack-dev.

…ck-dev

…ck-dev) * feat(tui): add local embedded TUI mode with terminal/chat aliases Adds a gateway-free local TUI path so users can run openclaw in their terminal without needing a running gateway process. - TuiBackend interface abstraction (tui-backend.ts) with EmbeddedTuiBackend implementation that drives the agent loop in-process - openclaw tui --local flag for local embedded mode - openclaw terminal / openclaw chat aliases that imply --local - /auth slash command with codex CLI delegation to avoid prolite plan issue - Default model display fallback on startup - Local-aware status text and log suppression - Concise auth error hints, raw HTML 403 suppression - Onboarding hatch flow launches local TUI (no gateway required) - Commander alias bug fix in run-main.ts (.aliases() check) - All new and updated tests passing (145/145) * TUI: fix alias detection, cross-platform codex lookup, and history byte-budget safeguards * TUI: remove RuntimeEnv type annotation to fix CI oxlint error * TUI: filter gateway-dependent tools and auto-approve plugin hooks in embedded mode * TUI: suppress console noise and add embedded mode system prompt note * TUI: reduce embedded-mode tool filtering from 15 to 7, add local session tools * TUI: fix remaining PR review comments * TUI: address latest review feedback and CI drift * Core: align prompt helper with latest base * Core: match prompt helper formatting with base * Core: restore prompt helper from latest base * fix(tui): preserve local auth fallback in source checkouts * fix(tts): guard telephony provider invocation * fix(tui): support Windows codex auth shim * fix(tui): harden local auth flow * fix: preserve embedded tool-first run events * fix(tui): keep embedded plugin approvals gated * fix(tui): restore embedded attempt import * fix(tui): resolve sessions in embedded stub * fix: add embedded TUI changelog entry (openclaw#66767) (thanks @fuller-stack-dev) * fix: pass setup TUI local mode through relaunch (openclaw#66767) (thanks @fuller-stack-dev) --------- Co-authored-by: Ayaan Zaidi <[email protected]>

…ck-dev

…ck-dev) * feat(tui): add local embedded TUI mode with terminal/chat aliases Adds a gateway-free local TUI path so users can run openclaw in their terminal without needing a running gateway process. - TuiBackend interface abstraction (tui-backend.ts) with EmbeddedTuiBackend implementation that drives the agent loop in-process - openclaw tui --local flag for local embedded mode - openclaw terminal / openclaw chat aliases that imply --local - /auth slash command with codex CLI delegation to avoid prolite plan issue - Default model display fallback on startup - Local-aware status text and log suppression - Concise auth error hints, raw HTML 403 suppression - Onboarding hatch flow launches local TUI (no gateway required) - Commander alias bug fix in run-main.ts (.aliases() check) - All new and updated tests passing (145/145) * TUI: fix alias detection, cross-platform codex lookup, and history byte-budget safeguards * TUI: remove RuntimeEnv type annotation to fix CI oxlint error * TUI: filter gateway-dependent tools and auto-approve plugin hooks in embedded mode * TUI: suppress console noise and add embedded mode system prompt note * TUI: reduce embedded-mode tool filtering from 15 to 7, add local session tools * TUI: fix remaining PR review comments * TUI: address latest review feedback and CI drift * Core: align prompt helper with latest base * Core: match prompt helper formatting with base * Core: restore prompt helper from latest base * fix(tui): preserve local auth fallback in source checkouts * fix(tts): guard telephony provider invocation * fix(tui): support Windows codex auth shim * fix(tui): harden local auth flow * fix: preserve embedded tool-first run events * fix(tui): keep embedded plugin approvals gated * fix(tui): restore embedded attempt import * fix(tui): resolve sessions in embedded stub * fix: add embedded TUI changelog entry (openclaw#66767) (thanks @fuller-stack-dev) * fix: pass setup TUI local mode through relaunch (openclaw#66767) (thanks @fuller-stack-dev) --------- Co-authored-by: Ayaan Zaidi <[email protected]>

…ck-dev

…ck-dev) * feat(tui): add local embedded TUI mode with terminal/chat aliases Adds a gateway-free local TUI path so users can run openclaw in their terminal without needing a running gateway process. - TuiBackend interface abstraction (tui-backend.ts) with EmbeddedTuiBackend implementation that drives the agent loop in-process - openclaw tui --local flag for local embedded mode - openclaw terminal / openclaw chat aliases that imply --local - /auth slash command with codex CLI delegation to avoid prolite plan issue - Default model display fallback on startup - Local-aware status text and log suppression - Concise auth error hints, raw HTML 403 suppression - Onboarding hatch flow launches local TUI (no gateway required) - Commander alias bug fix in run-main.ts (.aliases() check) - All new and updated tests passing (145/145) * TUI: fix alias detection, cross-platform codex lookup, and history byte-budget safeguards * TUI: remove RuntimeEnv type annotation to fix CI oxlint error * TUI: filter gateway-dependent tools and auto-approve plugin hooks in embedded mode * TUI: suppress console noise and add embedded mode system prompt note * TUI: reduce embedded-mode tool filtering from 15 to 7, add local session tools * TUI: fix remaining PR review comments * TUI: address latest review feedback and CI drift * Core: align prompt helper with latest base * Core: match prompt helper formatting with base * Core: restore prompt helper from latest base * fix(tui): preserve local auth fallback in source checkouts * fix(tts): guard telephony provider invocation * fix(tui): support Windows codex auth shim * fix(tui): harden local auth flow * fix: preserve embedded tool-first run events * fix(tui): keep embedded plugin approvals gated * fix(tui): restore embedded attempt import * fix(tui): resolve sessions in embedded stub * fix: add embedded TUI changelog entry (openclaw#66767) (thanks @fuller-stack-dev) * fix: pass setup TUI local mode through relaunch (openclaw#66767) (thanks @fuller-stack-dev) --------- Co-authored-by: Ayaan Zaidi <[email protected]>

…ck-dev

…ck-dev) * feat(tui): add local embedded TUI mode with terminal/chat aliases Adds a gateway-free local TUI path so users can run openclaw in their terminal without needing a running gateway process. - TuiBackend interface abstraction (tui-backend.ts) with EmbeddedTuiBackend implementation that drives the agent loop in-process - openclaw tui --local flag for local embedded mode - openclaw terminal / openclaw chat aliases that imply --local - /auth slash command with codex CLI delegation to avoid prolite plan issue - Default model display fallback on startup - Local-aware status text and log suppression - Concise auth error hints, raw HTML 403 suppression - Onboarding hatch flow launches local TUI (no gateway required) - Commander alias bug fix in run-main.ts (.aliases() check) - All new and updated tests passing (145/145) * TUI: fix alias detection, cross-platform codex lookup, and history byte-budget safeguards * TUI: remove RuntimeEnv type annotation to fix CI oxlint error * TUI: filter gateway-dependent tools and auto-approve plugin hooks in embedded mode * TUI: suppress console noise and add embedded mode system prompt note * TUI: reduce embedded-mode tool filtering from 15 to 7, add local session tools * TUI: fix remaining PR review comments * TUI: address latest review feedback and CI drift * Core: align prompt helper with latest base * Core: match prompt helper formatting with base * Core: restore prompt helper from latest base * fix(tui): preserve local auth fallback in source checkouts * fix(tts): guard telephony provider invocation * fix(tui): support Windows codex auth shim * fix(tui): harden local auth flow * fix: preserve embedded tool-first run events * fix(tui): keep embedded plugin approvals gated * fix(tui): restore embedded attempt import * fix(tui): resolve sessions in embedded stub * fix: add embedded TUI changelog entry (openclaw#66767) (thanks @fuller-stack-dev) * fix: pass setup TUI local mode through relaunch (openclaw#66767) (thanks @fuller-stack-dev) --------- Co-authored-by: Ayaan Zaidi <[email protected]>

…ck-dev

…ck-dev) * feat(tui): add local embedded TUI mode with terminal/chat aliases Adds a gateway-free local TUI path so users can run openclaw in their terminal without needing a running gateway process. - TuiBackend interface abstraction (tui-backend.ts) with EmbeddedTuiBackend implementation that drives the agent loop in-process - openclaw tui --local flag for local embedded mode - openclaw terminal / openclaw chat aliases that imply --local - /auth slash command with codex CLI delegation to avoid prolite plan issue - Default model display fallback on startup - Local-aware status text and log suppression - Concise auth error hints, raw HTML 403 suppression - Onboarding hatch flow launches local TUI (no gateway required) - Commander alias bug fix in run-main.ts (.aliases() check) - All new and updated tests passing (145/145) * TUI: fix alias detection, cross-platform codex lookup, and history byte-budget safeguards * TUI: remove RuntimeEnv type annotation to fix CI oxlint error * TUI: filter gateway-dependent tools and auto-approve plugin hooks in embedded mode * TUI: suppress console noise and add embedded mode system prompt note * TUI: reduce embedded-mode tool filtering from 15 to 7, add local session tools * TUI: fix remaining PR review comments * TUI: address latest review feedback and CI drift * Core: align prompt helper with latest base * Core: match prompt helper formatting with base * Core: restore prompt helper from latest base * fix(tui): preserve local auth fallback in source checkouts * fix(tts): guard telephony provider invocation * fix(tui): support Windows codex auth shim * fix(tui): harden local auth flow * fix: preserve embedded tool-first run events * fix(tui): keep embedded plugin approvals gated * fix(tui): restore embedded attempt import * fix(tui): resolve sessions in embedded stub * fix: add embedded TUI changelog entry (openclaw#66767) (thanks @fuller-stack-dev) * fix: pass setup TUI local mode through relaunch (openclaw#66767) (thanks @fuller-stack-dev) --------- Co-authored-by: Ayaan Zaidi <[email protected]>

…ck-dev

…ck-dev) * feat(tui): add local embedded TUI mode with terminal/chat aliases Adds a gateway-free local TUI path so users can run openclaw in their terminal without needing a running gateway process. - TuiBackend interface abstraction (tui-backend.ts) with EmbeddedTuiBackend implementation that drives the agent loop in-process - openclaw tui --local flag for local embedded mode - openclaw terminal / openclaw chat aliases that imply --local - /auth slash command with codex CLI delegation to avoid prolite plan issue - Default model display fallback on startup - Local-aware status text and log suppression - Concise auth error hints, raw HTML 403 suppression - Onboarding hatch flow launches local TUI (no gateway required) - Commander alias bug fix in run-main.ts (.aliases() check) - All new and updated tests passing (145/145) * TUI: fix alias detection, cross-platform codex lookup, and history byte-budget safeguards * TUI: remove RuntimeEnv type annotation to fix CI oxlint error * TUI: filter gateway-dependent tools and auto-approve plugin hooks in embedded mode * TUI: suppress console noise and add embedded mode system prompt note * TUI: reduce embedded-mode tool filtering from 15 to 7, add local session tools * TUI: fix remaining PR review comments * TUI: address latest review feedback and CI drift * Core: align prompt helper with latest base * Core: match prompt helper formatting with base * Core: restore prompt helper from latest base * fix(tui): preserve local auth fallback in source checkouts * fix(tts): guard telephony provider invocation * fix(tui): support Windows codex auth shim * fix(tui): harden local auth flow * fix: preserve embedded tool-first run events * fix(tui): keep embedded plugin approvals gated * fix(tui): restore embedded attempt import * fix(tui): resolve sessions in embedded stub * fix: add embedded TUI changelog entry (openclaw#66767) (thanks @fuller-stack-dev) * fix: pass setup TUI local mode through relaunch (openclaw#66767) (thanks @fuller-stack-dev) --------- Co-authored-by: Ayaan Zaidi <[email protected]>

…ck-dev

…ck-dev) * feat(tui): add local embedded TUI mode with terminal/chat aliases Adds a gateway-free local TUI path so users can run openclaw in their terminal without needing a running gateway process. - TuiBackend interface abstraction (tui-backend.ts) with EmbeddedTuiBackend implementation that drives the agent loop in-process - openclaw tui --local flag for local embedded mode - openclaw terminal / openclaw chat aliases that imply --local - /auth slash command with codex CLI delegation to avoid prolite plan issue - Default model display fallback on startup - Local-aware status text and log suppression - Concise auth error hints, raw HTML 403 suppression - Onboarding hatch flow launches local TUI (no gateway required) - Commander alias bug fix in run-main.ts (.aliases() check) - All new and updated tests passing (145/145) * TUI: fix alias detection, cross-platform codex lookup, and history byte-budget safeguards * TUI: remove RuntimeEnv type annotation to fix CI oxlint error * TUI: filter gateway-dependent tools and auto-approve plugin hooks in embedded mode * TUI: suppress console noise and add embedded mode system prompt note * TUI: reduce embedded-mode tool filtering from 15 to 7, add local session tools * TUI: fix remaining PR review comments * TUI: address latest review feedback and CI drift * Core: align prompt helper with latest base * Core: match prompt helper formatting with base * Core: restore prompt helper from latest base * fix(tui): preserve local auth fallback in source checkouts * fix(tts): guard telephony provider invocation * fix(tui): support Windows codex auth shim * fix(tui): harden local auth flow * fix: preserve embedded tool-first run events * fix(tui): keep embedded plugin approvals gated * fix(tui): restore embedded attempt import * fix(tui): resolve sessions in embedded stub * fix: add embedded TUI changelog entry (openclaw#66767) (thanks @fuller-stack-dev) * fix: pass setup TUI local mode through relaunch (openclaw#66767) (thanks @fuller-stack-dev) --------- Co-authored-by: Ayaan Zaidi <[email protected]>

…ck-dev

…ck-dev) * feat(tui): add local embedded TUI mode with terminal/chat aliases Adds a gateway-free local TUI path so users can run openclaw in their terminal without needing a running gateway process. - TuiBackend interface abstraction (tui-backend.ts) with EmbeddedTuiBackend implementation that drives the agent loop in-process - openclaw tui --local flag for local embedded mode - openclaw terminal / openclaw chat aliases that imply --local - /auth slash command with codex CLI delegation to avoid prolite plan issue - Default model display fallback on startup - Local-aware status text and log suppression - Concise auth error hints, raw HTML 403 suppression - Onboarding hatch flow launches local TUI (no gateway required) - Commander alias bug fix in run-main.ts (.aliases() check) - All new and updated tests passing (145/145) * TUI: fix alias detection, cross-platform codex lookup, and history byte-budget safeguards * TUI: remove RuntimeEnv type annotation to fix CI oxlint error * TUI: filter gateway-dependent tools and auto-approve plugin hooks in embedded mode * TUI: suppress console noise and add embedded mode system prompt note * TUI: reduce embedded-mode tool filtering from 15 to 7, add local session tools * TUI: fix remaining PR review comments * TUI: address latest review feedback and CI drift * Core: align prompt helper with latest base * Core: match prompt helper formatting with base * Core: restore prompt helper from latest base * fix(tui): preserve local auth fallback in source checkouts * fix(tts): guard telephony provider invocation * fix(tui): support Windows codex auth shim * fix(tui): harden local auth flow * fix: preserve embedded tool-first run events * fix(tui): keep embedded plugin approvals gated * fix(tui): restore embedded attempt import * fix(tui): resolve sessions in embedded stub * fix: add embedded TUI changelog entry (openclaw#66767) (thanks @fuller-stack-dev) * fix: pass setup TUI local mode through relaunch (openclaw#66767) (thanks @fuller-stack-dev) --------- Co-authored-by: Ayaan Zaidi <[email protected]>

openclaw-barnacle Bot added cli CLI command changes agents Agent runtime and tooling size: XL labels Apr 14, 2026

greptile-apps Bot reviewed Apr 14, 2026

View reviewed changes

Comment thread src/cli/tui-cli.ts Outdated

chatgpt-codex-connector Bot reviewed Apr 14, 2026

View reviewed changes

Comment thread src/cli/tui-cli.ts Outdated

Comment thread src/tui/tui.ts Outdated

Comment thread src/tui/embedded-backend.ts

openclaw-barnacle Bot added app: web-ui App: web-ui gateway Gateway runtime labels Apr 14, 2026

chatgpt-codex-connector Bot reviewed Apr 14, 2026

View reviewed changes

Comment thread src/tui/tui.ts Outdated

chatgpt-codex-connector Bot reviewed Apr 14, 2026

View reviewed changes

Comment thread src/tui/embedded-backend.ts

chatgpt-codex-connector Bot reviewed Apr 14, 2026

View reviewed changes

Comment thread src/tui/embedded-backend.ts Outdated

chatgpt-codex-connector Bot reviewed Apr 14, 2026

View reviewed changes

Comment thread src/cli/tui-cli.ts Outdated

chatgpt-codex-connector Bot reviewed Apr 15, 2026

View reviewed changes

Comment thread src/tui/tui.ts Outdated

Comment thread src/agents/pi-tools.before-tool-call.ts Outdated

chatgpt-codex-connector Bot reviewed Apr 15, 2026

View reviewed changes

Comment thread .github/workflows/ci.yml

Comment thread .github/workflows/ci.yml Outdated

openclaw-barnacle Bot added scripts Repository scripts and removed scripts Repository scripts labels Apr 15, 2026

openclaw-barnacle Bot added channel: whatsapp-web Channel integration: whatsapp-web scripts Repository scripts extensions: webhooks extensions: lmstudio labels Apr 17, 2026

chatgpt-codex-connector Bot reviewed Apr 17, 2026

View reviewed changes

Comment thread src/tui/tui.ts Outdated

chatgpt-codex-connector Bot reviewed Apr 17, 2026

View reviewed changes

Comment thread src/tui/tui.ts

openclaw-barnacle Bot removed channel: whatsapp-web Channel integration: whatsapp-web scripts Repository scripts extensions: webhooks extensions: lmstudio labels Apr 18, 2026

obviyus force-pushed the feat/local-embedded-tui branch from 458f2af to 74d4d28 Compare April 22, 2026 04:30

fix: pass setup TUI local mode through relaunch (openclaw#66767) (tha…

6d2acda

…nks @fuller-stack-dev)

obviyus approved these changes Apr 22, 2026

View reviewed changes

obviyus merged commit 276c000 into openclaw:main Apr 22, 2026
7 of 8 checks passed

github-actions Bot mentioned this pull request Apr 22, 2026

📡 Upstream Digest — 2026-04-22 04:41 UTC curtismercier/openclaw-mods#641

Open

perlowja mentioned this pull request Apr 23, 2026

[Bug] Agent tool-use regressed for all providers between v2026.4.20 and main — 0/6 models invoke tools on a cold-start prompt; multiple model families converge on fabricated "Exec is blocked on this session" phrase #70456

Closed

This was referenced Apr 29, 2026

TUI: Add config support for --deliver flag default #33102

Open

TUI process consumes 89-99% CPU at idle and during message turns (busy-loop) #75137

Closed

2026.4.29 TUI stays on connecting and spins CPU while gateway is healthy #75800

Closed

This was referenced May 3, 2026

[Bug]: Stuck and ultra slow during Hatch (terminal mode) - took a minute to come back up #74385

Closed

Feature: --agent flag for TUI to select which agent handles the session #8892

Open

This was referenced May 17, 2026

TUI --session mode doesn't live-stream messages #45388

Closed

feat(tui): add image attachment support via @path syntax and /image command #47859

Closed

feat(tui): show reconnect hint and auto-probe gateway when disconnected #43793

Closed

clawsweeper Bot mentioned this pull request May 24, 2026

feat(tui): clarify session state labels — distinguish Idle, Generating, Working, and Waiting states #56856

Closed

4 tasks

This was referenced Jun 14, 2026

feat: add context visualization in tui #59572

Closed

fix(tui): keep local slash commands out of model prompts #89183

Closed

This was referenced Jul 5, 2026

fix(tui): isolate embedded event listener failures #100117

Merged

[Feature]: Add $EDITOR compose mode in TUI (external editor handoff) for multiline prompts #22770

Open

fix(tui): render delta-only assistant streams #83000

Merged

Uh oh!

Uh oh!

Conversation

fuller-stack-dev commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Files Changed

Testing

Uh oh!

greptile-apps Bot commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Greptile Summary

Confidence Score: 5/5

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

JSy-LodgeLink commented Apr 14, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

fuller-stack-dev commented Apr 15, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

fuller-stack-dev commented Apr 15, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

fuller-stack-dev commented Apr 15, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

obviyus left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

obviyus commented Apr 22, 2026

Uh oh!

Reviewers

Assignees

fuller-stack-dev commented Apr 14, 2026 •

edited

Loading

greptile-apps Bot commented Apr 14, 2026 •

edited

Loading