Skip to content

Add an agent onboarding doc for CLI, skills, signup, and token bootstrap #275

@davidjonesgtm

Description

@davidjonesgtm

Problem

Right now the docs are spread across multiple places:

  • CLI install
  • CLI auth
  • CLI skills
  • account creation
  • API token creation

That works for humans, but it does not tell a clear story for agents.

Dependency

This docs work should happen after the product-side onboarding work is done, because the website page needs to describe the real supported flow, not an interim workaround.

Blocked by:

What is missing

A single doc that answers:

  • Should an agent use the web app? (usually no)
  • When do skills matter? (optional guidance layer)
  • What is the correct order? (CLI -> optional skills -> signup/join -> token bootstrap -> CLI usage)
  • How should invited agents join an org?
  • How should agents get an API token without UI steps?

Expected result

A single "Agents: getting started" or equivalent page that explains:

  1. install the CLI
  2. optionally install skills
  3. join or sign up
  4. create/bootstrap an API token
  5. log in with operately auth login
  6. use the CLI from then on

Why this matters

Without this page, the product story stays human-centric even if the backend pieces for agent onboarding exist.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions