Skip to content

docs: rewrite the readme with agent data paths and privacy details - #11

Merged
aikins01 merged 1 commit into
mainfrom
docs/readme
Oct 19, 2026
Merged

aikins01 merged 1 commit into
mainfrom
docs/readme

Conversation

@aikins01

Copy link
Copy Markdown
Contributor

The README said "Nothing leaves your machine", but the tool downloads the public models.dev price catalog, at most once an hour. It now says usage data stays on the machine and names that request as the only outbound one.

It also adds what a new user needs to run and trust the tool. The Node.js 22 requirement and the telemetry-stats command name for a global install are now stated, along with the short CLI flags. A warning says the dashboard and its API have no authentication, so --host 0.0.0.0 exposes usage data and the settings and sync endpoints to the network. The README now explains how syncing works and what Settings controls, what is stored and where, with TELEMETRY_STATS_DATA_DIR and how to reset, and the share card. The agent list is now a collapsed table of where each agent's data is read from, with its environment overrides, and says that Cursor, Antigravity, Trae, Warp / Oz, and MiniMax Code need tokscale's caches.

Images use raw.githubusercontent.com URLs, like the existing screenshot, so they also render on the npm page.

The Amp adapter reads ~/.local/share/amp/threads, which current Amp versions may no longer write. The README describes what the code reads; whether Amp support still works needs a separate check.

The README said nothing leaves the machine, but the tool downloads the
models.dev price catalog. It now names that request and states that
usage data stays local, warns that the dashboard has no authentication
when bound beyond localhost, and lists where each agent's data is read
from, with environment overrides.
@aikins01 aikins01 self-assigned this Oct 19, 2026
@aikins01
aikins01 merged commit 2b0c3f0 into main Oct 19, 2026
2 checks passed
@aikins01
aikins01 deleted the docs/readme branch October 19, 2026 02:38
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