agent_feed ✨🎞️

agent_feed turns local coding-agent activity into a projection-safe feed.

agent activity, reduced to signal.

what this is

agent_feed is a local Rust daemon, CLI, and browser surface for watching coding agents without showing raw logs.

the default product is local:

agent streams -> redaction -> story compiler -> local feed

it observes codex, claude, mcp, hooks, transcripts, JSONL streams, and generic telemetry surfaces. events are normalized, redacted, grouped into settled stories, then rendered as sparse feed bulletins.

the screen is meant to be left alone. no scrolling, no dashboard controls, no raw prompt/output/diff display.

getting started

cargo install agent_feed_cli --locked
agent-feed serve

the package is agent_feed_cli. the installed binary is agent-feed.

serve starts the local daemon and prints the display URL:

http://127.0.0.1:7777/reel

that is the happy path. serve also attaches the latest local codex and claude transcripts in the current workspace by default, so active sessions in that tree should start producing display-safe stories after the daemon is up. use --workspace /path/to/repo for another tree, --all-workspaces for broad local capture, or --no-agent-capture if you want to ingest manually. by default it tails future transcript writes only; add --include-history when you explicitly want to replay selected existing transcript history.

agent-feed init --auto is optional setup for hooks, shims, and future sessions. agent-feed open only opens the display URL in a browser.

to attach active local sessions manually:

agent-feed codex active --watch --workspace .
agent-feed claude active --watch --workspace .

to opt in only one workspace, add --workspace /path/to/repo to the codex, claude, or p2p publish commands. events without a matching cwd are ignored before import, story compilation, or p2p publishing.

for an existing transcript or stream:

agent-feed codex import path/to/codex-session.jsonl
agent-feed claude import path/to/claude-stream.jsonl

the normal local loop is: start the daemon, attach agent activity when you want capture, and leave the browser feed open.

safety boundary

raw prompts, secrets, absolute home paths, command output, and file diffs are not display material by default.

default posture:

• bind to 127.0.0.1
• no cloud
• no analytics
• raw event storage off
• aggressive redaction on
• path hashing on
• query params cannot weaken privacy

the feed is a view of agent activity, not an agent control plane.

p2p mode

p2p is optional. local mode remains the default.

agent-feed serve --p2p --publish --feed workstation

serve --p2p enables the network-aware browser/discovery UX. add --publish to make the same long-running process summarize future settled local stories and publish signed capsules under the named feed. publication is explicit and requires github auth; if there is no valid local auth session, the cli opens the github sign-in flow before it starts serving.

the current production network uses one low-cost bootstrap/edge peer and an edge snapshot fallback while the native libp2p data plane is brought up. it still publishes only signed, settled story capsules. it does not publish raw local events by default. subscribers receive already-summarized feed material. to publish from every local workspace:

agent-feed serve --p2p --publish --feed workstation --all-workspaces

the hosted browser shell is:

https://feed.aberration.technology/

local loopback streams are served by the local daemon, not scraped by the hosted static page:

http://127.0.0.1:7777/reel

with p2p enabled, the root page is the global discovery feed: it asks the edge for network bootstrap/snapshot material and displays any visible, settled story headlines. it never requests raw events.

https://feed.aberration.technology/?feed_mode=discovery
https://feed.aberration.technology/?feed_mode=following

user paths resolve github usernames through the edge. user/* is the wildcard form for all visible feeds from that user:

https://feed.aberration.technology/mosure
https://feed.aberration.technology/mosure/*
https://feed.aberration.technology/mosure/workstation

interactive timeline views can follow feeds in the browser. following is a local viewer selection; private feed access remains a signed protocol grant. fabric peers may help discovery/routing without following any feed.

repo shape

this is a Rust workspace with narrow crates for the CLI, local server, adapters, redaction, story compilation, summarization, browser UI, p2p protocol/runtime, edge support, and test fixtures.

most contributors should start with:

cargo xtask check

cargo xtask is a workspace alias for cargo run -p xtask --.

license

licensed under either of:

• apache license, version 2.0
• mit license