Docs Start here
Get started
You need three things:
- An access key for your workspace. The Phigon team issues it when your workspace is set up; book a demo if you don't have one.
- The Phigon app on the computer you supervise from.
- Node.js 24 or newer on each machine you want to supervise.
1. Install the Phigon app
The Phigon team gives you the app when your workspace is set up. Install it and open it. Paste your access key and choose Connect.
If your organization runs Phigon on its own servers, choose Using your own Phigon server? and enter the address your administrator gave you.
The key is stored encrypted on that computer, so you only paste it once. Settings → Sign out of this computer removes it.
2. Install the observer
On each machine you administer:
npm install --global @phigon/observer
The npm package is @phigon/observer; the command is phigon-observer. Releases for Windows, macOS, and Linux include their Guardian runner.
3. Choose what to collect
In the Phigon app, choose Connect machine and pick a profile before generating a one-time pairing code:
| Profile | What appears in Phigon |
|---|---|
| Metadata | Agent presence, state, health, and activity types; no message or tool content |
| Full activity | Supported prompts, replies, commands, tool outputs, and past conversations |
The machine owner reviews the exact scope on that machine and must accept it. Generating a code does not grant consent. Full activity is still limited by workspace policy and mandatory local secret redaction.
4. Pair and start
Copy the two commands from the dialog onto the machine. For metadata:
phigon-observer pair --code YOUR-CODE --consent-profile metadata
phigon-observer run --profile metadata
For full activity, use --consent-profile full when pairing and --profile full when running. Use the same profile in both commands.
Leave the observer running, or use your organization's managed-service setup. You can close the Phigon app; collection continues in the observer.
5. Check your machine
phigon-observer doctor --json
The machine should appear on Home in the Phigon app within a few seconds. Open an agent to inspect its activity and conversations. Coverage indicators show which sources are available, limited, or missing.
With full activity consent, the observer also imports supported past conversations. It resumes after a restart while live collection continues. Importing cannot recover content the source no longer keeps or that policy does not permit, and private provider-encrypted reasoning is never decoded.
Updating an existing installation
If you installed the old unscoped phigon-observer npm package, stop its process or managed service, then switch packages:
npm uninstall --global phigon-observer
npm install --global @phigon/observer
phigon-observer doctor --json
Keep your existing Phigon data directory and restart with the same profile; pairing and checkpoints are preserved. Update any managed-service path that points inside the old package. Future updates use npm install --global @phigon/observer@latest.