Security & Privacy

Agentoscope is designed to be private by default. Here's exactly how it works.

What Agentoscope accesses

Agentoscope reads the JSONL log files that Claude Code writes to ~/.claude/projects/ (and the XDG equivalent). These are the same logs Claude Code creates during normal operation.

It parses usage entries from these logs — model names, token counts, timestamps — and calculates costs using model pricing data. That's it.

Network activity

Agentoscope makes exactly one outbound network request: fetching the LiteLLM model pricing JSON from GitHub. This is a public, static JSON file used to calculate accurate costs for each model.

There is no other network activity. No analytics. No telemetry. No crash reporting. No update checks.

What Agentoscope cannot do

  • It cannot modify your Claude Code files — it's read-only
  • It cannot send your data anywhere — there's no upload mechanism
  • It cannot access files outside the Claude Code log directory
  • It cannot run in the background — it's a standard desktop app

Data storage

Agentoscope processes log data in memory only. It does not write any data to disk. When you close the app, the parsed data is gone. The next time you open it, it re-reads the JSONL logs fresh.

Open source

Agentoscope is fully open source under the GPL v3 license. You can read every line of Rust backend code and React frontend code on GitHub.

If you have security concerns, you're encouraged to audit the codebase and build from source.