Skip to content

docs: correct CLI login (email or phone, --local) and bootstrap-admin (--profile) #18

Closed as not planned

Description

@Bccorb

Epic: CLI accuracy (seamless-cli v0.8.0)
Source of truth: ../seamless-cli/src/commands/login.ts, src/commands/bootstrapAdmin.ts, src/core/help.ts

Why this matters

Two command descriptions are wrong in ways a user will hit immediately.

What to change

  • login in src/content/docs/operate/CLI.mdx (approx 160-167) and src/content/docs/reference/cli-commands.mdx (approx 149-157): the prompt accepts email OR phone (not email only), and there is a --local flag that reads the OTP from the instance response for local delivery.
  • bootstrap-admin in src/content/docs/operate/CLI.mdx (approx 116-119) and src/content/docs/reference/cli-commands.mdx (approx 132-167): it resolves the target from the active profile (SEAMLESS_API_URL override, then active profile instanceUrl, then http://localhost:3000) and accepts --profile <name>.

Acceptance criteria

  • login is documented as email-or-phone OTP with a --local flag.
  • bootstrap-admin documents active-profile resolution and --profile.
  • npm run lint && npm run typecheck && npm run build pass.

Working standards (read AGENTS.md)

  • Verify every claim against the source repo above at the tip of main before editing. If the code and the docs disagree, the code wins.
  • No em dashes in docs or PR text. No AI attribution in commits, PRs, or docs.
  • Branch docs/<short-name>; commit as docs: ... (Conventional Commits).
  • Quality gates before opening the PR (all must pass): npm run lint, npm run typecheck, npm run build.

Line numbers are approximate and may drift; search by the quoted text.

Activity

  1. added
    docs-accuracyDocs out of sync with source repos
    documentationImprovements or additions to documentation
    bugSomething isn't working
    on Jul 21, 2026
  2. Bccorb commented on Oct 5, 2026

    @Bccorb
    ContributorAuthor

    Superseded by #44 and fixed in #46. The bootstrap-admin command was removed from seamless-cli; the first admin is now the account registered with the owner email given to seamless init. #46 also corrects login (portal) versus profile login (instance).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingdocs-accuracyDocs out of sync with source reposdocumentationImprovements or additions to documentationpriority: mediumDo next

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions