Skip to content

docs(terminal): distinguish the terminal, VMark MCP and AI browser tools - #1588

Merged
xiaolai merged 3 commits into
mainfrom
docs/issue-1571-ai-cli-boundaries
Oct 20, 2026
Merged

xiaolai merged 3 commits into
mainfrom
docs/issue-1571-ai-cli-boundaries

Conversation

@xiaolai

@xiaolai xiaolai commented Oct 20, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds a terminal-guide section that separates the integrated terminal, VMark's MCP tools, and the AI client's own browser tools.
  • Records how to verify browser access (read a real page title from the session) and why a zero exit code or a catalog name proves nothing.
  • Documents the restart boundary between a CLI process and a shared background app-server, and warns against remote debugging or copied trust overrides as a workaround.
  • All ten locales updated; the website builds.

Closes #1571

Source

Based on the reporter's verified experience report. It is deliberately not a clean-install recipe, and the text keeps that boundary.

Validation

  • pnpm lint:doc-joins — 6 joins clean
  • pnpm lint:emdash
  • cd website && pnpm build
  • pnpm check:predelta

…ols (WI-DOC1.1)

Users running an AI CLI such as Codex CLI from VMark's terminal can see a
browser tool in the session and reasonably assume VMark provides it. The new
section states who provides each of the three surfaces — the PTY, VMark's MCP
tools, and the client's own browser integration — and how to verify a browser
connection (read a real page title, not an exit code or a catalog name). It also
records the restart boundary and warns against remote debugging or copied trust
overrides as a workaround.

The report in #1571 is presented as an experience report, not a clean-install
recipe, and the text keeps that boundary.

Docs updated in all ten locales.

Refs #1571
@xiaolai
xiaolai merged commit ff1afd0 into main Oct 20, 2026
13 checks passed
@xiaolai
xiaolai deleted the docs/issue-1571-ai-cli-boundaries branch October 20, 2026 03:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: verified Chrome access from Codex CLI in VMark terminal, with setup and restart boundaries

1 participant