v0.8.12 / v0.11.0
LingTai TUI/Portal v0.8.12 + Kernel v0.11.0
A coordinated release window for the Go TUI/Portal and the Python/Rust kernel. The TUI reaches v0.8.12 with safer first-run recovery, safer Homebrew upgrades, clearer MCP controls, Rust sidecar diagnostics, and dev-runtime protection; the kernel reaches v0.11.0 to mark the Rust-backed rewrite line and ships on PyPI after full release validation.
Upgrade / runtime
The kernel/runtime package lingtai==0.11.0 is published on PyPI, but ordinary LingTai projects do not upgrade it with a bare pip install. The TUI owns each project runtime through its managed virtualenv and resolves the kernel package there.
New features and improvements
-
01
TUI/Portal v0.8.12: recovery and upgrade paths are safer
The desktop-facing release closes several sharp edges around first-run setup, OAuth/no-key presets, and in-app Homebrew upgrades.
- First-run and recovery setup now persist
~/.lingtai-tui/config.json, preventing repeated setup loops for OAuth or no-key presets. - The in-app Homebrew upgrade prompt now detects other running TUI processes, asks for explicit confirmation, sleeps affected agents, stops old TUIs, and asks the user to relaunch instead of self-execing an old Cellar binary.
- The release keeps the upgrade UX discoverable while avoiding the dangerous multi-window upgrade case that can leave old and new TUI processes fighting each other.
Why it matters:Install and upgrade paths are the first thing new users touch. They must be boringly reliable before the agent network can feel alive.
- First-run and recovery setup now persist
-
02
MCP is now the human-facing control surface
The TUI command surface now says what the system actually is: external integrations are MCP resources and controls, not a separate addon philosophy.
-
/mcpreplaces/addonas the human-facing command and palette entry. - The MCP control panel copy is reframed around MCP resources, status, and configuration instead of platform-specific onboarding hard-coded in the TUI.
- Stale
/addonreferences were cleaned across command dispatch, i18n, docs, and packaged recipes.
Why it matters:This keeps the TUI thin: MCP packages own their own knowledge, while the TUI gives humans a clear doorway into that knowledge.
-
-
03
Core capabilities and local dev runtimes are protected
Setup and preset editing now distinguish the immutable runtime floor from optional model/provider capabilities, while dev-mode kernel installs stay editable and local.
- Core/default capabilities are always included; editable preset checkboxes focus on optional capabilities such as web search and vision.
-
LINGTAI_DEV_ROOTis the explicit dev-mode contract for keeping runtime virtualenvs pointed at the locallingtai-kernelcheckout. - Runtime repair no longer silently turns a developer’s editable install back into a PyPI wheel when the project is meant to test local kernel changes.
Why it matters:Users get fewer ways to accidentally remove the ground beneath an agent, and developers get a reliable loop for testing kernel changes.
-
04
Rust sidecar diagnostics land in `/doctor`
The TUI now exposes the packaged Rust file-search sidecar status and local Rust/Cargo readiness instead of hiding Python fallback behind symptoms.
-
/doctorreports packaged Rust sidecar status for the file-search path. - It also reports local Cargo/Rust availability, which matters when rebuilding or diagnosing sidecar fallback.
- Startup can now prompt when the system falls back to Python because Cargo is missing.
Why it matters:The Rust-backed line should be diagnosable from the product itself, not only from source checkout archaeology.
-
-
05
Kernel v0.11.0 marks the Rust-backed runtime line
The kernel package on PyPI moves to
0.11.0, not another patch release, because this release window crosses a rewrite boundary for the Rust-backed runtime pieces.- The PyPI package
lingtai==0.11.0was built fromlingtai-kernelmain commit3b0758fand published with both wheel and sdist artifacts. - Release-blocking kernel tests were triaged: stale path/wording/timer expectations were updated, then the full suite passed with
1969 passed, 2 skippedbefore the version bump release. - A clean virtualenv install from PyPI verified
import lingtai, lingtai_kerneland distribution version0.11.0.
Why it matters:The version number now matches the architectural weight of the change, and the public package is verified rather than merely tagged.
- The PyPI package
-
06
Packaged guidance and release discipline were tightened
This window also updated the guidance agents carry with them: GitHub operations, Claude Code token debugging, and release-log expectations.
- Shipped guidance now teaches agents to use
GH_TOKENor existinggh authfor GitHub operations instead of asking humans to paste shell commands. - Swiss-knife Claude Code docs now explain stale
CLAUDE_CODE_OAUTH_TOKENsources, safeenv -uwrappers, shell startup file diagnostics, and inherited environment gotchas. - The release process now records the two-layer convention: concise GitHub Release notes plus a longer human-facing HTML release log.
Why it matters:Operational knowledge should ship with LingTai. Every release should leave the next release easier to do correctly.
- Shipped guidance now teaches agents to use
Contributors
Thanks to everyone whose PRs or reported/closed issues are represented in this release window.
Validation
Final release validation was run from a clean release worktree at commit a8259ea31bf1.
- TUI tests go test ./... passed
- TUI build/version build passed; version v0.8.11-22-ga8259ea before tag
- Portal web build npm ci && npm run build passed
- Portal Go tests go test ./... passed
- Portal build make build passed
- Kernel full pytest before v0.11.0 1969 passed, 2 skipped
- Kernel package build/check build and twine check passed
- PyPI verification lingtai==0.11.0 latest, wheel + sdist present
- Clean virtualenv install import lingtai and lingtai_kernel succeeded