Skip to content

[Good first issue]: Add a 60-second kaios tour transcript #19

@morning-verlu

Description

@morning-verlu

Goal

Add a short docs walkthrough that shows what a first-time user should see when they run kaios tour.

This should help visitors understand the Evidence OS loop before they install or run anything locally.

Suggested scope

  • Add a compact section to docs/LOCAL_TOUR.md or START_HERE.md.
  • Show the key output moments, not the full terminal log.
  • Include the product mapping: Agent = Process, Tool = Syscall, Run = Evidence, CI = Gate.
  • Link to the generated artifacts a user should inspect after the tour.

Verification

For a docs-only PR, run:

git diff --check

If you can run the CLI locally, also run:

./gradlew installDist
build/install/kaios-cli/bin/kaios tour --dir /tmp/kaios-tour-check

Notes

Keep the PR narrow. This should be a beginner-friendly transcript, not a rewrite of the whole onboarding flow.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationevidenceEvidence OS traces, capsules, replay, and review artifactsgood first issueGood for newcomershelp wantedExtra attention is needed

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions