Skip to content

docs(cli): rewrite cli/README.md for accuracy and readability#3202

Open
fnalways wants to merge 1 commit into
beclab:mainfrom
fnalways:docs/cli-readme
Open

docs(cli): rewrite cli/README.md for accuracy and readability#3202
fnalways wants to merge 1 commit into
beclab:mainfrom
fnalways:docs/cli-readme

Conversation

@fnalways

@fnalways fnalways commented May 29, 2026

Copy link
Copy Markdown
Member

Summary

Rewrites cli/README.md to be more accurate and readable. The previous version had several inaccuracies and was dense in places.

  • Restructures the README around the three runtime modes (host, user, in-cluster) with a clear modes table up front.
  • Fixes the login flow: it is an interactive password + TOTP prompt via the --olares-id flag, not a browser-based login.
  • Replaces the nonexistent profile current command with profile list / profile whoami.
  • Corrects the Linux credential storage path to ~/.local/share/olares-cli/.
  • Marks in-cluster mode as planned, matching the current stub in pkg/credential/env_provider.go.
  • Aligns terminology and Agent Skills descriptions with the developer docs, clarifies the npm install methods, and condenses verbose sections.

Test plan

  • Render cli/README.md on GitHub and confirm headings, tables, and internal links resolve.
  • Confirm the documented commands (profile login --olares-id, profile list, profile whoami, install methods) match current CLI behavior.

Made with Cursor


Note

Low Risk
Documentation-only change to cli/README.md; no runtime or security behavior is modified.

Overview
Rewrites cli/README.md for clarity and alignment with current CLI behavior, without changing product code.

The doc is reorganized around host / user / in-cluster (planned) modes, with shorter install paths (wizard, global npm, npx) and a dedicated Agent Skills section. It corrects user-facing details: interactive profile login --olares-id (password + TOTP), profile list / profile whoami instead of profile current, Linux token storage at ~/.local/share/olares-cli/, and -o json shorthand. Long scenario tables, wizard edge cases, and duplicate “Linux host side-by-side” prose are trimmed or merged into one special-case block; security, command layering, and repo layout sections are condensed to match the same mental model.

Reviewed by Cursor Bugbot for commit 6abb93f. Bugbot is set up for automated code reviews on this repo. Configure here.

Restructure the CLI README around the three runtime modes (host, user,
in-cluster) and fix several inaccuracies in the previous version:

- Correct the login flow: interactive password + TOTP via the
  `--olares-id` flag, not a browser-based login.
- Replace the nonexistent `profile current` command with
  `profile list` / `profile whoami`.
- Fix the Linux credential path to `~/.local/share/olares-cli/`.
- Mark in-cluster mode as planned to match the current stub in
  pkg/credential/env_provider.go.

Also condense verbose sections, align terminology and Agent Skills
descriptions with the developer docs, and clarify install methods.

Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel

vercel Bot commented May 29, 2026

Copy link
Copy Markdown

@fnalways is attempting to deploy a commit to the Lucky's projects Team on Vercel.

A member of the Team first needs to authorize it.

@fnalways fnalways requested a review from pengpeng May 29, 2026 11:15
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.

1 participant