Skip to content

Update from code changes: document full CLI and plugin command surface - #2

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/f0a375f9
Open

Update from code changes: document full CLI and plugin command surface#2
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/f0a375f9

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Summary

Bring the docs in line with the shipped CyberOS 1.0.0 surface — all eight npx cyberos commands and the nine Claude plugin slash commands, including the previously undocumented CLI-only create, gates, and mcp and the task-workflow slash commands /plan, /create-tasks, and /improve.

Changes

  • guides/install.mdx — new "The npx cyberos CLI surface" section enumerating all eight commands (with a pointer to the MCP Gateway module for mcp), and rewrote "Updating CyberOS" to reflect that re-vendoring is the only update path.
  • guides/plugin-setup.mdx — split the plugin command table into CLI-parity and task-workflow groups; removed the non-existent /update and /changelog; added /plan, /create-tasks, and /improve; updated the description and step copy.
  • quickstart.mdx — replaced /update and /changelog in the plugin command table with the actually-shipped commands, and rewrote the npx cyberos update snippet as npx cyberos version + install.
  • reference/changelog.mdx — expanded the "Consumer CLI finalised" bullet to name the CLI-only create, gates, mcp and the plugin-only task-workflow slash commands, and updated the Claude Plugin accordion to include the task-workflow commands.
  • vi/guides/install.mdx and vi/reference/changelog.mdx — mirrored the same updates in Vietnamese.

Context

Follows cyberskill-official/cyberos#56, which closed the same documentation gap in the shipped installer GUIDE.

Greptile Summary

This PR updates the CyberOS command documentation for the 1.0.0 surface.

  • Adds the full eight-command npx cyberos CLI table.
  • Replaces the old update flow with version plus idempotent install.
  • Splits Claude plugin commands into CLI-parity and task-workflow groups.
  • Mirrors the install and changelog updates in selected Vietnamese docs.

Confidence Score: 4/5

Low-risk documentation update with one localized consistency issue.

The English docs are internally consistent, while the remaining issue is non-blocking and limited to stale Vietnamese command references reached from the updated install guide.

vi/guides/install.mdx, plus the linked vi/guides/plugin-setup.mdx and vi/quickstart.mdx pages.

T-Rex T-Rex Logs

What T-Rex did

  • The after capture validation confirmed successful navigation to the updated English pages and matching page titles in the Mintlify app.
  • The /guides/install page was validated to surface the npx cyberos CLI surface section as shown in the after-change render.
  • The /guides/plugin-setup page was validated to include CLI-parity commands and task-workflow slash commands, including /ship-tasks, /plan, /create-tasks, and /improve.
  • The textual guidance explicitly states there is no /update or /changelog command, aligning with the PR objective.

View all artifacts

T-Rex Ran code and verified through T-Rex

Important Files Changed

Filename Overview
guides/install.mdx Adds the complete npx cyberos command surface and updates the update workflow to use version plus idempotent install.
guides/plugin-setup.mdx Reworks plugin command documentation into CLI-parity and task-workflow groups, removing stale /update and /changelog references.
quickstart.mdx Updates quickstart plugin and CLI examples to use the shipped command surface instead of the removed update/changelog commands.
reference/changelog.mdx Expands the 1.0.0 changelog to describe CLI-only and plugin-only commands consistently.
vi/guides/install.mdx Mirrors the install/update command changes in Vietnamese, but now links to localized plugin docs that still describe the old command surface.
vi/reference/changelog.mdx Mirrors the changelog command-surface updates in Vietnamese.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  User[CyberOS user] --> CLI[npx cyberos CLI]
  User --> Plugin[Claude plugin slash commands]
  CLI --> Install[install uninstall version status help]
  CLI --> CLIOnly[create gates mcp]
  Plugin --> Parity[install uninstall version status help]
  Plugin --> Workflow[ship-tasks plan create-tasks improve]
  Version[version check] --> Revendor[install re-vendors cyberos]
  Parity --> Version
  Install --> Revendor
Loading
%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
  User[CyberOS user] --> CLI[npx cyberos CLI]
  User --> Plugin[Claude plugin slash commands]
  CLI --> Install[install uninstall version status help]
  CLI --> CLIOnly[create gates mcp]
  Plugin --> Parity[install uninstall version status help]
  Plugin --> Workflow[ship-tasks plan create-tasks improve]
  Version[version check] --> Revendor[install re-vendors cyberos]
  Parity --> Version
  Install --> Revendor
Loading

Fix All in Claude Code Fix All in Devin Fix All in Cursor Fix All in Codex Fix All in Conductor

Prompt To Fix All With AI
Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
vi/guides/install.mdx:46
**Vietnamese docs remain stale**
This new pointer sends Vietnamese readers to `vi/guides/plugin-setup.mdx`, but that page still documents only five commands and tells users to run the removed `/update` and `/changelog` commands. The same stale command list remains in `vi/quickstart.mdx`, so the localized docs contradict the new CLI surface introduced here.

Reviews (1): Last reviewed commit: "docs: mirror plugin/quickstart command u..." | Re-trigger Greptile

Greptile also left 1 inline comment on this PR.

@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cyberos-wiki 🟢 Ready View Preview Jul 20, 2026, 2:13 AM

Comment thread vi/guides/install.mdx
Không có lệnh `apply` hay `update`. Re-vendor luôn là `npx cyberos install` — an toàn khi chạy bất cứ lúc nào và không bao giờ ghi đè `BACKLOG.md`, nhiệm vụ, `AGENTS.md`, hay `gates.env` của bạn. Kiểm tra cập nhật mềm chạy tự động mỗi khi có bất kỳ thứ gì dưới `.cyberos/` được sử dụng.
</Note>

Với workflow nhiệm vụ, Claude plugin còn cung cấp thêm `/ship-tasks`, `/plan`, `/create-tasks` và `/improve`. Chúng chỉ có trong plugin — xem [Thiết lập Plugin](/vi/guides/plugin-setup).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Vietnamese docs remain stale
This new pointer sends Vietnamese readers to vi/guides/plugin-setup.mdx, but that page still documents only five commands and tells users to run the removed /update and /changelog commands. The same stale command list remains in vi/quickstart.mdx, so the localized docs contradict the new CLI surface introduced here.

Prompt To Fix With AI
This is a comment left during a code review.
Path: vi/guides/install.mdx
Line: 46

Comment:
**Vietnamese docs remain stale**
This new pointer sends Vietnamese readers to `vi/guides/plugin-setup.mdx`, but that page still documents only five commands and tells users to run the removed `/update` and `/changelog` commands. The same stale command list remains in `vi/quickstart.mdx`, so the localized docs contradict the new CLI surface introduced here.

How can I resolve this? If you propose a fix, please make it concise.

Fix in Claude Code Fix in Devin Fix in Cursor Fix in Codex Fix in Conductor

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.

0 participants