Appendix
A. Mode A unavailable surfaces
Mode A is Matcha CLI in this build: local files, and a Provider you bring your own key for. There is no MatchaCode account and no official cloud.
Some command names still parse. They are leftovers in the binary, not procedures. Do not walk through product OAuth, device-code login, in-app update, share URLs, or a plugin marketplace. If a substitute exists, the table names it.
A disabled surface is a hard stop. The CLI does not look up DNS, open HTTP or WebSocket, queue, or retry for it.
What Mode A does teach
Use these. They are the local + BYOK path.
- Talk to the model through the Provider you configured, and list that Provider’s catalog (cached locally).
- Store a Provider API key on this machine.
- Local sessions, workspace, skills, plugins, memory on disk, and MCP servers you configure yourself.
- Local usage, traces, and crash files.
- Assistant and tool execution on this machine, including local LSP servers.
matcha login --provider xaiThe same shape works for openai, anthropic, ollama, and openai_compatible. That is BYOK. It is not a MatchaCode login.
User-visible names that are not procedures
These entries can still be typed. Treat them as unavailable. Use the substitute when one exists.
| Name | Why it is out | Use instead |
|---|---|---|
matcha login --oauth / --oidc / --device-auth / --device-code | Account OAuth and device-code login | matcha login --provider <id> |
/login (typed; omitted from menus) | Same; prints BYOK examples | matcha login --provider <id> |
| Welcome-screen product OAuth / device-code chrome | No MatchaCode account | Provider key on the welcome configure path |
matcha update (and in-app auto-update) | No installer or update channel | Build from source |
matcha setup | Remote config sync | Local ~/.matcha/config.toml / MATCHA_* |
matcha share, /share (hidden from CLI and slash menus) | No share URL | /export, matcha export |
matcha workspace (hidden from CLI) | No computer hub or remote workspace | Local /dashboard, matcha worktree |
/docs web | No in-app web docs URL | /docs in the TUI |
/feedback (omitted from menus) | No feedback upload | — |
/marketplace, matcha plugin marketplace … | No remote marketplace | Local /plugins, matcha plugin install <path> |
/imagine, /imagine-video | Media tools are not registered | — |
/voice (fail-closed until revealed) | No speech-to-text service | Type in the composer |
/announcements remote push | No remote announcement feed. /release-notes is not a substitute | /docs and matcha --version |
/release-notes / /changelog | No remote changelog; typed command fail-closes and tells you to use /docs | /docs and matcha --version |
/privacy remote policy / training opt-in | No remote coding-data plane | /privacy opens local Settings → Coding data |
/usage manage | No MatchaCode bill, subscription, or account usage | Bare /usage / /cost (local metering) |
/flush, /dream inference | No memory LLM jobs | /memory on/off, /remember, local store |
matcha trace without --local | No diagnostic export endpoint | matcha trace --local |
| Web fetch / web search tools | Provider web tools are off | User-configured local MCP, if you need it |
| Cloud Agent / remote workspace | No product cloud workspace | Local /fork, /config-agents, matcha worktree |
| Conversation cloud sync | Sessions stay on disk | matcha sessions, /resume |
| Product relay / headless WebSocket relay | No hosted relay | matcha agent stdio, local matcha leader |
| Remote skills / chat-mode catalog | No product catalogs | Local /skills |
| Managed MCP gateway | No hosted connectors | matcha mcp, /mcps |
| Git plugin source (unapproved egress) | Remote git plugin install is off | Local plugin path |
| Remote settings / campaigns | No control plane | ~/.matcha/config.toml, /settings |
| Review comment upload | No commercial account | — |
| Telemetry / OTLP / error / heap / auth-diag upload | No diagnostic export | Local crash files |
| HTTP hook URLs | Unapproved user egress | Local command hooks (/hooks) |
| User-configured LSP socket | Unapproved user egress | Local LSP servers |
Forty-eight surfaces stay off
The table above is the user-visible subset. Forty-eight further surfaces in this build stay disabled. They are not procedures either. Most never appear as commands.
- Account, device-code, and product-identity login.
- Remote session lists, conversation sync, and writeback.
- Share URLs, cloud assistant, remote workspace, and workspace hub (
matcha workspace). - Product relay and relay session sync.
- Remote skill catalogs, managed MCP, MCP marketplace, remote git plugin sources, and plugin marketplace.
- Remote settings, managed config sync (
matcha setup), remote chat-mode catalogs, and remote sub-assistant bundles. - Feedback upload, review-comment upload, account usage, billing, and subscription chrome.
- Remote privacy / training opt-in, remote announcements, campaigns, and
/release-notes. - Trace upload, product telemetry, OTLP export, auth-diagnostics upload, error reporting, and heap-profile upload.
matcha update.- Arbitrary LSP sockets, speech-to-text, web fetch, web search, image and video generation, HTTP hook URLs.
- Memory embedding,
/dream, and/flushinference jobs.
Related: Configure a Provider (BYOK); Memory; Migrating from Grok Build.