You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[Bug] /docs/cli/integrations documents 'mcode app-server' subcommand, but no released @minimax-ai/code version (≤ 0.3.4) ships it #139
The public CLI documentation page https://agent.minimax.io/docs/cli/integrations describes an app-server subcommand with three sub-modes (--stdio, --listen unix://..., proxy, daemon {start|stop|status|restart|version}), but no released version of @minimax-ai/code exposes that subcommand.
mcode app-server (and any of its sub-options/arguments) prints the top-level mcode --help text plus error: unknown option '<flag>' on stderr, because app-server is not registered as a subcommand.
The page also says: "The app-server is for Remote Control clients and custom integrations. Regular mcode and mcode exec tasks do not need to start it." and "Serve mode" option table includes --stdio, --listen, --data-dir, --workspace, --state-file, --foreground. — none of these flags are recognized by the CLI shipped to users.
Impact
Anyone reading the docs to integrate mcode as a service (rather than one-shot mcode exec) will find that:
The CLI does not start.
The Command reference (/docs/cli/reference) lists mcode app-server [options], mcode app-server proxy, mcode app-server daemon [action] under the top-level commands, but those entries are unreachable from the binary.
Suggested action
Either:
(a) ship the app-server subcommand in the next release so the docs match reality, or
(b) gate the app-server section in /docs/cli/integrations and /docs/cli/reference behind a "coming soon" / "available in version ≥ X.Y.Z" note until it ships, so integrators don't burn time on a command that doesn't exist.
Also worth adding: even when app-server ships, please publish the JSON-RPC method list (session/start, turn/start, etc.) — the current docs page describes transport options but not the wire schema, so a custom client still can't be written from the public docs alone.
Environment
$ mcode --version
0.3.4
$ node --version
v25.3.0
$ uname -a
Linux ... ...
CLI installed via npm (@minimax-ai/code@0.3.4); no source-build involved.
Thank you for the detailed report, and sorry for the confusion. The app-server feature is still in internal testing and is not available in the current public release. We have corrected the documentation to remove the premature references. We will notify you when a future release makes this feature publicly available.
Closing as completed through the documentation correction requested in this issue. I rechecked both https://agent.minimax.io/docs/cli/integrations and https://agent.minimax.io/docs/cli/reference: the premature app-server commands have been removed, and the public integration surface is documented as mcode acp. This closure does not claim that app-server has shipped; any future app-server release and its protocol documentation remain separate work.
Activity
1anZhang commentedon Sep 7, 2026
Thank you for the detailed report, and sorry for the confusion. The
app-serverfeature is still in internal testing and is not available in the current public release. We have corrected the documentation to remove the premature references. We will notify you when a future release makes this feature publicly available.hetaoBackend commentedon Sep 19, 2026
Closing as completed through the documentation correction requested in this issue. I rechecked both https://agent.minimax.io/docs/cli/integrations and https://agent.minimax.io/docs/cli/reference: the premature app-server commands have been removed, and the public integration surface is documented as mcode acp. This closure does not claim that app-server has shipped; any future app-server release and its protocol documentation remain separate work.