CONNECT YOUR AGENT

A drop in skill for any skill capable agent: markdown instructions plus plain Python, no platform lock in. It runs the poll loop, persists the cursor, backs off on rate limits, and renders briefings matched to your interests.

The bundle ships with your key and has four files:

• SKILL.md the instructions your agent follows
• wire_client.py the heartbeat client, cursor persistence, retry logic
• briefing.py renders a readable briefing from the last batch
• interests.yaml your topics, keywords, and minimum confidence
• agentwire.py the same heartbeat as a single file CLI, no dependencies

Once installed, the loop is two commands:

python3 wire_client.py --once --limit 100   # poll the wire
python3 briefing.py                        # render your briefing

The client advances the cursor only after a batch is processed, treats resync as a fresh snapshot, and never re fetches just to check. Read SKILL.md for the full workflow.

Prefer a terminal? One file, standard library only, zero dependencies. Download it and run it anywhere Python lives.

curl -sSL https://app.agentwire.online/agentwire.py -o agentwire
chmod +x agentwire
export AGENTWIRE_KEY=your_key
./agentwire status

Heads up: the product is being renamed from AgentWire to NewsLiar. The CLI still answers to agentwire for now. The command name follows in the full migration.

Four subcommands:

• status check the wire's health
• wire poll for new clusters and events
• briefing poll, then render your interest grouped briefing
• watch poll on a loop and print new clusters as they land

Auth resolves from the AGENTWIRE_KEY env var, the --api-key flag, or a key saved in ~/.agentwire_key. The cursor lives in ~/.agentwire_cursor and advances after every successful poll.

Running a Claude Code style harness? commands/agentwire.md in the skill bundle is a drop in /agentwire slash command. Install it and the CLI answers to /agentwire briefing like any other command.

Prefer your own loop? One endpoint, one key, cursor semantics. Start at cursor 0.

curl "https://wire.agentwire.online/v2/wire?cursor=0&limit=100" \
  -H "Authorization: Bearer YOUR_KEY"

The rules of the road:

• Process every cluster and event in the batch, then advance to next_cursor.
• If the response has resync set to true, your cursor expired. Rebuild state from the batch as a full snapshot.
• Back off on 429 and 5xx. Never hammer the endpoint.
• Filter server side with category and min legs to keep payloads small.
• The wire gives headlines, entities, and source links, not article bodies. Fetch the source URLs yourself when you need depth.

The full contract lives here. If anything on this page disagrees with the manual, the manual wins.

https://wire.agentwire.online/.well-known/agentwire.json

Skeptical about the numbers? Good. The methodology page documents every signal from the actual code, including the known limitations. Read it before you trust a score.