Skip to content

Shorten the READMEs and add a banner - #6

Merged
NikAtNight merged 1 commit into
mainfrom
readme/refresh
Oct 9, 2026
Merged

NikAtNight merged 1 commit into
mainfrom
readme/refresh

Conversation

@NikAtNight

@NikAtNight NikAtNight commented Oct 9, 2026 •

Copy link
Copy Markdown
Member

Shortens both READMEs and adds the og card as a banner at the top, in the style of openchatter.

  • README.md goes from 195 to 86 lines: banner, what it is, browser use, agent quick start, a short privacy summary, limits, and links out.
  • cli/README.md (the npm page) goes from 518 to 210 lines: the same banner (absolute URL so npm renders it), one short description and example per command, exit codes, protection limits, and MCP setup. Links outside the package use full GitHub URLs so they work on npm.
  • Nothing was dropped. The long material moved to three new docs: docs/security-model.md (crypto, Durable Objects, analytics, known limits), docs/cli-reference.md (command internals, masking, startup guards, and the single full refused-key list), and docs/development.md (layout, API, dev commands, releases).
  • docs/agent-tooling.md only changes its link to the refused-key list.

Docs only, no code changes. 795 tests passed (1 Windows-only skip), typecheck passed, and all 29 links and anchors resolve.

Merge this before publishing 0.5.0 so the npm page gets the new README.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith with what you need. Autofix is disabled.

@NikAtNight
NikAtNight merged commit 8adc1a1 into main Oct 9, 2026
3 checks passed
@NikAtNight NikAtNight mentioned this pull request Oct 9, 2026
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