feat(tui): lazy-create the session on first use with the v2 engine by liruifengv · Pull Request #2458 · MoonshotAI/kimi-code

liruifengv · 2026-07-31T07:59:41Z

Related Issue

No linked issue — this is part of the ongoing agent-core-v2 engine rollout for the interactive TUI.

Problem

The TUI eagerly creates a session at startup (KimiTUI.init calls harness.createSession even when the user has not sent anything yet). Under the v2 engine this is unnecessary: a workspace handler can exist without a session, the main agent is only materialized on first use, and skills live on the workspace rather than the session. Eager creation also means the session appears in the picker / persisted session store before the user has done anything.

What changed

With the v2 engine (KIMI_CODE_EXPERIMENTAL_FLAG), the TUI now starts session-less and creates the session on first use:

Startup: non-resume startups no longer create a session; --session / --continue resume and the --session "" picker behave as before. The footer shows the config defaults the engine would apply at createSession time (model, defaultPermissionMode, defaultPlanMode, thinking effort, context cap) so nothing goes blank while waiting.
First use triggers creation: sending a message, a bash-mode command, a session-requiring slash command (/plan /compact /goal /undo /web /fork /export-* /init /btw /swarm), or a skill/plugin command lazy-creates the session via a shared ensureSession() path; the Shift-Tab plan toggle shares it. Mode/read-only commands stay session-less: /yolo /auto /permission update the pending state the first session picks up, while /settings /plugins /usage /status /title and /add-dir list read config or workspace-level views without creating one. /login, /model, /logout, /provider, /reload, /copy, /theme and other session-independent commands never trigger creation; activateModelAfterLogin no longer creates a session after login/model switch.
Skills without a session: refreshSkillCommands falls back to harness.listWorkspaceSkills(workDir) when no session exists, which reads the Workspace-scope IWorkspaceSkillCatalog — the same merged view (builtin / user / explicit / extra / plugin) a session would serve. Plugin commands are already app-global under v2, so a new KimiHarness.listPluginCommands() exposes them session-less (the base RPC returns an empty list for v1).
Workspace-level /mcp: with no session yet, /mcp reads the workspace handler's shared MCP connection set (awaiting its initial load) instead of failing with "no active session".
First-use concurrency: concurrent triggers share one in-flight ensureSessionPromise; /new, the /sessions picker, and model/effort switches wait out the in-flight creation before acting, and idle-only commands (/add-dir, skill/plugin commands, /new) re-check their busy gate after the wait — matching steady-state semantics instead of racing a second createSession or mutating mid-turn.
--agent / --agent-file: the startup agent binding is carried in appState and applied to the first lazy-created session, instead of being lost when session creation moves out of init().
/plugins: fixed a latent unhandled-rejection when the command runs without an active session (its internal requireSession throw was dispatched via void).
The v1 engine path is unchanged: all lazy-creation branches are guarded by the v2 flag, so v1 keeps its historical eager-creation behavior.

Checklist

I have read the CONTRIBUTING document.
I have linked a related issue, or explained the problem above.
I have added tests that prove my feature works.
Ran gen-changesets skill, or this PR needs no changeset.
Ran gen-docs skill, or this PR needs no doc update.

Start the interactive TUI session-less under the v2 engine and create the session on first use (message, bash input, or a session-requiring slash command) instead of at startup. Skills and plugin commands are resolved from the workspace/app-global catalogs without a session, and the footer shows config defaults (model, permission, plan mode, thinking effort, context cap) until the session exists.

changeset-bot · 2026-07-31T07:59:45Z

⚠️ No Changeset found

Latest commit: fa9dd23

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

pkg-pr-new · 2026-07-31T08:02:20Z

pnpm dlx https://pkg.pr.new/@moonshot-ai/kimi-code@fa9dd23

npx https://pkg.pr.new/@moonshot-ai/kimi-code@fa9dd23

commit: fa9dd23

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d3755653bd

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

…king Concurrent first-use triggers (double Enter, a slash command right after a prompt) both observed `session === undefined` and created their own session, letting the later setSession close the first one mid-dispatch. Share an in-flight creation promise instead. A session-only thinking choice (model picker Alt+S) made before the first session exists only updated appState, so the lazy-created session fell back to the engine default while the footer showed the chosen effort. Carry it as a first-session thinking override and clear it on creation.

liruifengv · 2026-07-31T08:24:02Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 79fe2a18cb

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

The v2 engine applies config.defaultPlanMode at session create time (sessionLifecycleService), so passing the pre-filled appState.planMode as the create override entered plan mode twice and threw 'Already in plan mode' on the first message. Pass only the explicit CLI --plan intent for session-less v2 creation; the config default stays footer-only.

liruifengv · 2026-07-31T08:47:56Z

@codex review

…ation

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cd52d72a04

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

…ings session-less A bash command submitted while the first prompt is still being lazy-created shared the in-flight creation promise but resumed past handleUserInput's busy check, running runShellCommand concurrently with the prompt. Re-check streamingPhase after the await and queue instead. /settings is a local settings entry point: opening it must not require or create a session, so it no longer triggers lazy creation; its session-requiring sub-items keep their own errors.

liruifengv · 2026-07-31T09:03:10Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2e21d4cfa3

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

…ins session-free A skill/plugin or idle-only slash command submitted while the first prompt was still being lazy-created shared the in-flight creation promise but resumed past the availability check resolved before the await, running concurrently with the prompt's turn. Re-check the busy gate after the shared await in the skill, plugin-command and builtin dispatch paths. /plugins is app-global on the v2 engine, so a session-less startup no longer creates a session (or fails with LLM-not-set) just to manage plugins: the harness now exposes the global plugin API and the command routes through it until a session exists.

liruifengv · 2026-07-31T09:26:09Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c5e87a1ccd

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

The bare and `list` forms already tolerate a missing session, but the blanket lazy-create gate forced a session (or failed with LLM-not-set) before they could run. Only the path-adding form needs a live session, so it now lazy-creates inside the handler instead of in the dispatch preflight.

liruifengv · 2026-07-31T09:43:05Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c7392b65bf

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

…nds after reload /add-dir list looked only at session.summary, so pending startup additionalDirs were reported as absent until a session existed; fall back to appState when session-less. /plugins reload updated the app-global service but left the TUI's plugin slash-command map stale, so new or re-enabled commands kept parsing as prompts; rebuild it from the reloaded service (which also covers the app-global path before the first session exists).

liruifengv · 2026-08-01T08:34:16Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bccb66a734

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

…-entry /reload refreshed only the model/provider dictionaries while session-less, so defaults edited externally (or a newly added default model) left appState.model empty/stale and the first lazy-created session failed with LLM-not-set or used the old value. Reuse the startup default-hydration path for the no-session reload case. /plan on as the first command with defaultPlanMode=true re-entered plan mode after the engine had already applied the config default at create, throwing Already in plan mode. Skip the call when the session is already in the requested mode.

liruifengv · 2026-08-01T08:57:01Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d2cffe2ed7

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

hydrateLazyConfigDefaults only patched model when the reloaded config still had a default, so removing defaultModel from config.toml left appState.model stale and the first lazy-created session passed it explicitly instead of failing or following the engine's current defaults. Reset model and context cap when the default is gone.

liruifengv · 2026-08-01T09:09:07Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6423c5f4a1

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

…ess picker

liruifengv · 2026-08-04T03:48:06Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d5b03f2ecf

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

… creation

liruifengv · 2026-08-04T04:13:59Z

@codex review

liruifengv · 2026-08-04T04:22:50Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4089a1618f

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4089a1618f

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

liruifengv · 2026-08-04T04:40:30Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 07d509fe0f

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

…start

liruifengv · 2026-08-04T04:56:33Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ec70188ba9

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

…workspace commands on reload

liruifengv · 2026-08-04T05:10:22Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0f752cb7e6

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

… creation

liruifengv · 2026-08-04T05:53:23Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 27e712f5e4

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

liruifengv · 2026-08-04T06:57:05Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fd60d1b7df

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

…icker

liruifengv · 2026-08-04T07:12:54Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1c8dd7d4a6

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

liruifengv · 2026-08-04T07:46:49Z

@codex review

chatgpt-codex-connector Bot reviewed Jul 31, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/kimi-tui.ts

Comment thread apps/kimi-code/src/tui/kimi-tui.ts

chatgpt-codex-connector Bot reviewed Jul 31, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/kimi-tui.ts Outdated

Merge remote-tracking branch 'origin/main' into feat/lazy-session-cre…

e30180d

…ation

chatgpt-codex-connector Bot reviewed Jul 31, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/kimi-tui.ts

Comment thread apps/kimi-code/src/tui/commands/dispatch.ts Outdated

chatgpt-codex-connector Bot reviewed Jul 31, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/commands/dispatch.ts

Comment thread apps/kimi-code/src/tui/commands/dispatch.ts Outdated

chatgpt-codex-connector Bot reviewed Jul 31, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/commands/dispatch.ts Outdated

chatgpt-codex-connector Bot reviewed Jul 31, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/commands/add-dir.ts Outdated

Comment thread apps/kimi-code/src/tui/commands/plugins.ts

test(tui): add pluginCommandMap to the MessageDriver interface

5562fd7

chatgpt-codex-connector Bot reviewed Aug 1, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/kimi-tui.ts Outdated

Comment thread apps/kimi-code/src/tui/commands/dispatch.ts

chatgpt-codex-connector Bot reviewed Aug 1, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/kimi-tui.ts

liruifengv added 2 commits August 1, 2026 17:04

test(tui): widen the getConfig mock return type for the reload case

0bce21a

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/kimi-tui.ts

fix(tui): hydrate the model default thinking effort for the session-l…

d5b03f2

…ess picker

style(tui): trim verbose comments in the lazy-default fixes

c68b20a

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/controllers/auth-flow.ts

Comment thread apps/kimi-code/src/tui/commands/dispatch.ts

fix(tui): hydrate lazy defaults after login, serialize /new with lazy…

4089a16

… creation

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/commands/dispatch.ts

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/commands/add-dir.ts

fix(tui): re-check the busy gate after lazy /add-dir session creation

07d509f

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/kimi-tui.ts

fix(tui): let Shift-Tab lazy-create the session on a v2 session-less …

ec70188

…start

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/controllers/auth-flow.ts

Comment thread apps/kimi-code/src/tui/commands/reload.ts

fix(tui): hydrate session-less defaults on model-less login, refresh …

0f752cb

…workspace commands on reload

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/commands/dispatch.ts

fix(tui): re-check the idle-only gate for /new after waiting out lazy…

27e712f

… creation

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/controllers/auth-flow.ts

fix(tui): wait out lazy creation before accepting model/effort switches

fd60d1b

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/commands/dispatch.ts

fix(tui): wait out lazy creation before switching sessions from the p…

1c8dd7d

…icker

chatgpt-codex-connector Bot reviewed Aug 4, 2026

View reviewed changes

Comment thread apps/kimi-code/src/tui/kimi-tui.ts

fix(node-sdk): read session-less skills from the workspace skill catalog

fa9dd23

Uh oh!

Conversation

liruifengv commented Jul 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Related Issue

Problem

What changed

Checklist

Uh oh!

changeset-bot Bot commented Jul 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

pkg-pr-new Bot commented Jul 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

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!

liruifengv commented Jul 31, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

liruifengv commented Jul 31, 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!

liruifengv commented Jul 31, 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!

liruifengv commented Jul 31, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

liruifengv commented Jul 31, 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!

liruifengv commented Aug 1, 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!

liruifengv commented Aug 1, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

liruifengv commented Aug 1, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

liruifengv commented Jul 31, 2026 •

edited

Loading

changeset-bot Bot commented Jul 31, 2026 •

edited

Loading

pkg-pr-new Bot commented Jul 31, 2026 •

edited

Loading