Skip to Content
BorkerBorker Docs
Sources

Sources

Point Borker at the feeds you care about, your own published work and your build log, and it turns what they bring in into posts for your week.

Topics keep your week full. Sources keep it current. A source is something Borker reads for you, regularly, and each new item it finds can become a post. There are three kinds, and each one reaches your week in its own way.

How a source reaches your week

Three kinds of source, each with its own way in.

PlanningNothing is written yet.
ReactiveThings happening in your world.
The wind tableWeather station88%match
A match at or above your level
Borker plans it, often the same day
Below your levelPlan it anyway
◌ 12:40Planned

The wind table

Written a few hours before it goes out

PersonalReacting to: The wind table
RedistributionYour own published work.
The tunnel notebookWorkshopNot yet shared
New pieces: Borker paces them
Borker plans one post per channel, at your pace
I plan themPlan it
◌ 08:15Planned

The tunnel notebook

Written a few hours before it goes out

BrandFrom your own piece: The tunnel notebook
Build logWhat you are working on, in the order it happened.
852 feet in 59 secondsShipped · Day 4Not yet planned
New entries: Borker paces them
Borker plans it on the channels picked for it
I plan themPlan it
◌ 13:10Planned

852 feet in 59 seconds

Written a few hours before it goes out

PersonalFrom your build log: Day 4
Mon◌◌
Tue◌◌
Wed◌◌
Thu◌◌
Fri◌
Sat◌
Sun◌
PlanningNothing is written yet.
Things happening in your world.
The wind tableWeather station88%match
A match at or above your level
Borker plans it, often the same day
Below your levelPlan it anyway
◌ 12:40Planned

The wind table

Written a few hours before it goes out

PersonalReacting to: The wind table
Mon◌◌
Tue◌◌
Wed◌◌
Thu◌◌
Fri◌
Sat
Sun◌
PlanningNothing is written yet.
Your own published work.
The tunnel notebookWorkshopNot yet shared
New pieces: Borker paces them
Borker plans one post per channel, at your pace
I plan themPlan it
◌ 08:15Planned

The tunnel notebook

Written a few hours before it goes out

BrandFrom your own piece: The tunnel notebook
Mon◌◌
Tue◌
Wed◌◌
Thu◌◌
Fri◌
Sat
Sun◌
PlanningNothing is written yet.
What you are working on, in the order it happened.
852 feet in 59 secondsShipped · Day 4Not yet planned
New entries: Borker paces them
Borker plans it on the channels picked for it
I plan themPlan it
◌ 13:10Planned

852 feet in 59 seconds

Written a few hours before it goes out

PersonalFrom your build log: Day 4
Mon◌◌
Tue◌
Wed◌◌
Thu◌◌
Fri◌
Sat◌
Sun◌
Read it as steps
  1. Reactive. Things happening in your world. Borker reads each new item against your strategy and gives it a match with a short reason.
  2. A match at or above your level gets a place in your week, often the same day. One under it shows as Below your level, and Plan it anyway still gives it a place.
  3. Redistribution. Your own published work. Your own pieces get no match: each new one shows as Not yet shared.
  4. With New pieces: Borker paces them, each piece gets one post per channel, at the pace you choose. With I plan them, it waits until you press Plan it.
  5. Build log. What you are working on, in the order it happened. Your agent sends each entry, and it shows as Not yet planned.
  6. With New entries: Borker paces them, each entry gets a place on the channels picked for it. With I plan them, it waits until you press Plan it.
  7. Each one arrives in Planning as a planned post: a place in your week. Nothing is written yet.
KindWhat it is
ReactiveThings happening in your world: news, blogs, feeds
RedistributionYour own published work: your blog, your newsletter
Build logWhat you are working on, sent by your coding agent

You set sources up in Settings → Sources. You see what they turned up on the Sources page in the main navigation, one tab per kind.

Add a source

Open Settings → Sources and find Add a source.
Pick the kind: Reactive or Redistribution.
Give it a name, like TechCrunch AI, and paste the address of its feed.

Press Add source. Borker checks the address before it adds it, and starts reading within the hour.

An address Borker cannot read is refused under the field, with the reason. Only workspace admins and owners add, change or remove sources. A build log is not added here: it appears once your agent sends its first entry. See Build log.

What Borker watches

Every source, with its name, address and kind. A source Borker suggested while setting up your strategy carries Picked for you and is read like any other.

On a rowWhat it does
Check nowOn a Redistribution feed, reads it right away instead of waiting for the next read. Once a minute at most.
EditChanges the name, the address or the kind. On a Redistribution feed, also its pace and channels.
RemoveBorker stops reading it and forgets what it turned up.

A feed that will not read says why on its row, for example "Could not read this feed: it did not answer in time". The line goes away after the next good read.

From a source item to a post

Every item follows the same two stages as the rest of Borker. First it becomes a planned post in Planning: a place in your week, nothing written yet. A few hours before that time, Borker writes it, and it arrives in Posts as a draft in Review, waiting for you unless its voice publishes on its own.

Each kind decides on its own which items get a place. Every kind shares the same buttons on the Sources page for planning one yourself:

ButtonWhat happens
Plan itAsks "When should this go out?" Pick a day and time, or press Next free, and tick where it goes.
Skip itSets the item aside. It stays on the list with its reason.
Plan it anywayPlans an item that was set aside.
Replan for…Adds an item that is already planned to more channels.

A planned row shows when and where it goes, with a link to it in the Command Center. Check now at the top of the Reactive and Redistribution tabs reads every source of that kind at once. Only admins plan and skip.

One item on the Reactive tab, opened to show why it matched, with the Plan it chooser open below: Where it goes and When should this go out?

A post written from a source carries a link back to it: a reaction links to the article, a post from your own piece links to the piece. Borker adds the link when the post goes out, where each channel puts links. Posts from your build log carry no link.

ChannelWhere the link goes
XThe last post of the thread. A single post becomes a two-post thread.
LinkedIn profile and pageOn its own line at the end of the post
BlueskyA link card, or at the end of the text when the post has a picture
FarcasterThe cast's embed
ParagraphIn the body, after the first paragraph

Where the link goes

Posts link to the piece they came from. Each channel has its own place for the link.

The pieceFrom one of your sources.
The wind tableWeather stationweather.example

Borker adds the link when the post goes out

PostsThe same post, in each channel's shape.
  • Personal

    Goes out as the last post of the thread.

    1/2

    Three weeks of wind tables said wait.

    2/2

    weather.example

  • PersonalBrand

    Goes on its own line at the end of the post.

    Three weeks of wind tables said wait.

    weather.example

  • Personal

    Goes out as a link card, or at the end of the text when the post has a picture.

    Three weeks of wind tables said wait.

    The wind tableweather.example

  • Brand

    Goes out as the cast's embed.

    Three weeks of wind tables said wait.

    The wind tableweather.example

  • Brand

    Goes in the body after the first paragraph.

    Three weeks of wind tables said wait.

    Read the original: weather.example

Two switches on the Links in posts card turn links on or off for a whole kind. Both start on.

  • Reactive links: posts that react to an article
  • Redistribution links: posts made from your own pieces

To change the link on one post, open it, press Edit and use the Link field: replace the address, Remove it, or press Use the piece's link to go back to the original.

On X, a post that carries a link spends one X URL credit. With none left, Borker offers to add a pack or to send the post without its link. See Billing.

Sent by your agent

Sources an agent sends to, like your build log, appear on this card in Settings → Sources once the first entry arrives. Each has its own tab on the Sources page and a switch for whether Borker paces new entries into your week or holds them for you.

Each kind in detail

On this page