Questions and answers
Before your first session.
The short answers about using Zyphr and reading its records. Product source publication is pending.
01
Evaluation
What the project is and where it stands.
Can I install Zyphr today?
The public product repository is still empty. Source publication is pending, and this site does not offer a release binary. The installation page explains the publication status and intended source setup.
What does Zyphr do?
Zyphr records coding-agent activity on your machine. Native hooks supply tool events. An optional process-scoped proxy records routed HTTP(S) requests and applies explicit egress rules. The local console joins these records into sessions and findings.
Which agents have native adapters?
The current implementation has adapters for Claude Code, Cursor, and Pi. Each adapter records the events its agent exposes. Coverage differs by agent. Adding an agent label to a command does not install an adapter.
Other clients may work through the proxy if they honor its proxy and certificate settings. That does not provide native tool events. Read the adapter overview.
Is there a hosted service or team plan?
The current project is a local engine and console. There is no hosted Zyphr account system or team service to sign up for. Managed deployment and organization policy distribution are later work.
02
Setup and data
What runs locally and what leaves your machine.
What system does the local implementation use?
The current source targets Linux and macOS. It uses a Go CLI, a local collector, SQLite, and a browser console. It does not require a separate database server or a cloud account. Check the published source requirements when source becomes available.
Does Zyphr send my session records to this website?
No. The local application has no Zyphr telemetry service or automatic remote upload. This website does not connect to your collector. Your coding agent still sends requests to model providers and other destinations.
Website visits pass through Cloudflare. See Privacy for the separate website and application scopes.
Are prompts and responses stored by default?
No. Prompt and response capture is off by default. Optional content capture uses redaction and encryption. Redaction can miss secrets, and event metadata can still contain sensitive paths or command fragments.
Optional capture encryption does not mean the whole SQLite database is encrypted. Read capture and local data before enabling it.
Does Zyphr install a system certificate?
The proxy uses a runtime-scoped certificate authority for HTTPS inspection. Zyphr does not install that CA in the operating system trust store. A client can reject interception, including through certificate pinning.
Can I rename my Lantern data directory?
Keep existing Lantern data and hooks intact until you follow an explicit migration procedure. The project name changing does not make a directory rename safe. See the Lantern lineage note.
03
Evidence and limits
What a record can establish.
Does Zyphr block unsafe tool calls?
Native hooks observe activity and remain permissive. Findings do not independently veto tool calls. Explicit proxy deny rules can block HTTP(S) requests routed through the proxy.
This is not a sandbox or an operating system security boundary. See the observation and policy model.
Can an agent bypass the proxy?
Yes. A program can ignore proxy settings or use a network path the proxy does not handle. Code running as your user can also change user-owned hooks, binaries, keys, and records. Policy applies only on the proxy path.
What happens if the collector or proxy fails?
Hook or collector failure must not deny tool execution. The proxy has different failure behavior. An explicit deny blocks a request, setup failure can stop the wrapped command, and transport failure can interrupt a request. Zyphr must not silently retry an uncertain write.
Does a finding prove that data was stolen?
No. A finding points to supporting events and an interpretation. A suspicious sequence is a reason to investigate. A socket connection alone does not prove which plaintext crossed TLS. Missing events do not establish that an action was safe.
Is the sample session on this site real?
No. The homepage session uses synthetic data to explain how records fit together. It is not a product screenshot, live connection, test result, or record of a compromise. The recorder illustration is artwork.
Still missing an answer? Contact Hari with the task you have in mind.