Skip to content

Document credential scanning in the public docs - #342

Merged
mando merged 1 commit into
mainfrom
mando/document-credential-scanning
Aug 19, 2026
Merged

Document credential scanning in the public docs#342
mando merged 1 commit into
mainfrom
mando/document-credential-scanning

Conversation

@mando

@mando mando commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Summary

Argus scans session text for pasted credentials (#327, #336) and surfaces the result in the session banner, the timeline, the session list, the Activity recommendations, argus status and the Hub's Tasks view. None of it was documented for readers. This adds it where each audience would look.

Page Change
sessions.md New Credential warnings section, the main writeup: the banner and what each line says, the timeline markers, Dismiss / Show again, the list badge, the Flagged filter and its hidden-session behavior
privacy.md New Credential warnings section: local pattern matching, no model, only a redacted hint stored, and the one flag per task that reaches a Hub. Also amends the "What's sent stays minimal" bullet
terminology.md New Credential warning glossary entry, alphabetical between Cost and Dashboard
how-it-works.md A paragraph in the background-indexing section, including that already-indexed sessions get checked by the backlog pass
metric-views.md Recommendations bullet notes the credential warning leads the list
argus-hub/tasks.md New Credential warnings section: the count under the heading, Show only these, the per-task pill, and that details stay local while dismissal does not clear the flag
argus-hub/mcp.md The flagged filter on query_tasks and query_task_quality
mcp-server.md Warnings ride the transcript-access switch, since they are derived from text the user chose not to share
cli-reference.md status reports credential-check progress
settings-reference.md Retain-session-text row: new sessions are checked either way, re-checking indexed ones needs index refresh

Notes

Says "credential warning", not "secret". The published docs already use "secret" for the argus secret API-key store, so a second meaning of that word on the same site would be a trap. This also matches the strings the UI, the CLI and the recommendation already show.

No screenshots. docs/contributing/technical-writing.md requires synthesized data, so capturing the banner and the Flagged list against fake fixtures is a follow-up rather than part of this change.

No positioning change. This documents a capability without changing how Argus is described, so docs/contributing/positioning.md and its surface inventory are untouched. Putting credential scanning into the promise or the canonical descriptions would be a positioning change first.

Test plan

  • bun run docs:build passes, so no dead links or bad anchors
  • Skim the rendered pages for tone against docs/contributing/voice-and-tone.md

🤖 Generated with Claude Code

Argus scans session text for pasted credentials and surfaces the result in
several places, but none of it was documented for readers. Add it where each
audience would look for it.

Sessions gets the main writeup (the banner, the timeline markers, dismissal,
the list badge and the Flagged filter), Privacy gets what is stored and what
crosses the sync wire, and Terminology gets the glossary entry the rest link
to. How It Works, Metric Views, the Hub's Tasks and MCP pages, the local MCP
server page, the CLI reference and the settings reference each pick up the
part that belongs to them.

Says "credential warning" throughout rather than "secret", since the docs
already use "secret" for the argus secret API-key store.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@mando
mando merged commit 2dda3e2 into main Aug 19, 2026
1 check passed
@mando
mando deleted the mando/document-credential-scanning branch August 19, 2026 19:28
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