phigon-observer
v0.1.7
Published
Consent-based local observer for Phigon AI agent supervision.
Readme
Phigon Observer
Connect your AI coding agents to Phigon, the consent-based supervision workspace for authorized AI activity.
Phigon helps you see:
- which approved machines are connected;
- which AI agents are installed or running;
- current activity and agent health;
- saved agent threads and history when sharing is approved.
Phigon is consent-based. The observer starts with privacy-safe metadata only, and sensitive activity remains protected unless the machine owner approves it.
How to use
- Sign in at phigon.online.
- Select Connect machine and generate a one-time code.
- Install the observer:
npm install --global phigon-observer- Pair the machine with the command shown in Phigon:
phigon-observer pair --code YOUR-CODE --consent-profile metadata- Start supervision:
phigon-observer runTo monitor an agent that does not have a built-in adapter, register its local signals once. Definitions are reloaded on every discovery and activity scan:
phigon-observer agent add \
--id release-bot \
--name "Release Bot" \
--executable release-bot \
--process release-bot-worker \
--config-path ~/.release-bot \
--activity-dir ~/.release-bot/sessionsUse phigon-observer agent list to inspect the active definitions and
phigon-observer agent remove --id release-bot to stop using one. Custom
activity remains visibly source-isolated unless independent process-lifetime
evidence proves one exact match. Activity directories accept bounded JSONL and
expand ~/ against the current user's home directory. Paths must be absolute
or home-relative, activity roots must be narrowly scoped, and overlapping
identity or activity signals are rejected instead of guessed.
To disconnect and unregister the paired machine from that machine itself:
phigon-observer remove-machineThe command requires local confirmation, revokes the machine credential, and clears it only after the control plane confirms removal. Workspace retention and administrator-managed historical data deletion remain separate controls.
Return to Phigon to view the machine, grouped AI agents, live status, health, and available history.
Phigon includes optimized support for Codex, Claude Code, Cursor, GitHub Copilot, OpenCode, Gemini CLI, and more, while the dynamic registry and custom NDJSON bridge support locally authorized custom agents without a code change.
