Skip to content

docs: add a Security page - #26

Merged
kannandreams merged 1 commit into
mainfrom
docs/security-page
Sep 10, 2026
Merged

docs: add a Security page#26
kannandreams merged 1 commit into
mainfrom
docs/security-page

Conversation

@kannandreams

Copy link
Copy Markdown
Owner

Summary

  • New docs/security.md under Project: what agent-top reads (metadata only), what it never does (no writes, no signals, no shell-outs, no unsafe code), the two network calls it can make enumerated exactly (version check, trace --endpoint), the one fixed command line the upgrade prompt runs, and the files it touches on disk.
  • Reworded "The longer view of what agent-top is and is not is in Vision" in Why this exists into a clearer sentence, per feedback that the original was hard to parse.

Test plan

  • mise run docs:build (strict) passes.
  • Verified the rendered page with a headless-Chrome screenshot; all inline links resolve.

New Project-section page enumerating the security model that follows
from being read-only and local-only: what it reads (metadata only, no
prompt text or tool output), what it never does (no writes, no
signals, no shell-outs, no unsafe), the exact two network calls it can
make, the one fixed command line the upgrade prompt runs, and the
files it touches on disk.

Also rewords "The longer view of what agent-top is and is not is in
Vision" into a clearer see-also sentence.
@kannandreams
kannandreams merged commit 8d712ca into main Sep 10, 2026
@kannandreams
kannandreams deleted the docs/security-page branch September 10, 2026 07:42
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