Skip to content

docs: update README for self-serve setup#316

Merged
tumberger merged 3 commits into
mainfrom
docs/readme-self-serve
Jun 25, 2026
Merged

docs: update README for self-serve setup#316
tumberger merged 3 commits into
mainfrom
docs/readme-self-serve

Conversation

@tumberger

@tumberger tumberger commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Present kontext setup as the primary self-serve path.
  • Frame self-serve around agent activity, hooks, and the daemon.
  • Remove outdated kontext start / managed-session framing from the first-read flow.

Verification

  • Not run; README-only change.

Copy link
Copy Markdown
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@tumberger tumberger force-pushed the docs/readme-self-serve branch 2 times, most recently from be629f3 to 1c477d6 Compare June 19, 2026 13:23
@tumberger tumberger force-pushed the docs/readme-self-serve branch from 1c477d6 to ea592d2 Compare June 24, 2026 11:53
@tumberger tumberger requested a review from michiosw June 24, 2026 12:52
@tumberger tumberger marked this pull request as ready for review June 24, 2026 12:53
@greptile-apps

greptile-apps Bot commented Jun 24, 2026

Copy link
Copy Markdown

Greptile Summary

This PR updates the README to make self-serve setup the main onboarding path. The main changes are:

  • Presents kontext setup as the primary Mac workspace connection flow.
  • Reframes the runtime path around agent hooks, the daemon, and hosted streaming.
  • Replaces local-session and managed-session language with deployment-oriented docs.
  • Updates the security defaults, agent support table, and architecture diagram text.

Confidence Score: 5/5

This looks safe to merge, with a few wording fixes worth making.

  • No blocking issues found in the changed code.
  • A few README statements can overstate setup, uninstall, and Cowork behavior.
  • The comments are documentation clarity issues, not runtime breakages.

README.md

Important Files Changed

Filename Overview
README.md Updates self-serve setup, daemon, dashboard stream, and agent support documentation.

Reviews (1): Last reviewed commit: "Merge branch 'main' into docs/readme-sel..." | Re-trigger Greptile

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
- Claude Code: observe by default, enforce only via managed config
- Claude Cowork: active by default through kontext setup managed hooks
- uninstall: note keychain token removal and kept local data/org hooks
- tighten judge-model wording, unwrap prose to one line per paragraph

@michiosw michiosw left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Reviewed README against the code and recent commits — all factual claims verified true (LaunchAgent label/command, hook subcommands, managed.json path, SQLite store, judge-after-deterministic-allow, RFC 8693 token exchange, observe default, macOS-only). Three doc-accuracy points raised by the bot are resolved: uninstall scope and Claude Code enforce wording corrected as suggested; Cowork row updated to reflect that it is active by default via managed hooks since #338 (not the legacy cowork_enabled path). Approving — do not merge yet.

@michiosw michiosw left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Verified README claims against code and recent commits; all true. Three bot-flagged doc points resolved (uninstall scope, Claude Code enforce wording, and Cowork now active-by-default via managed hooks since #338). Do not merge yet.

@michiosw michiosw left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Verified all README claims against the code and recent commits — accurate. Three bot doc points resolved: uninstall scope and Claude Code enforce wording corrected; Cowork row updated to active-by-default via managed hooks (#338), not the legacy cowork_enabled path. Approving; do not merge yet.

@tumberger tumberger merged commit e2362e4 into main Jun 25, 2026
5 checks passed
@tumberger tumberger deleted the docs/readme-self-serve branch June 25, 2026 09:16
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.

2 participants