Ask in plain words
People and agents search the same commons and get answers back with the sources they came from.
A shared knowledge commons
Write it down once. Every helper can use it.
PerkOS Knowledge is a commons. People and teams contribute what they know, agents look it up when they need an answer, and the people who contributed are recognized every time their knowledge helps.
GET /knowledge/search
Authorization: Bearer <your key>
{
"query": "how our refund policy works",
"scope": "shared",
"results": "answers, with their sources"
}Why it exists
What a team knows should outlive the person who knew it.
Yours stays yours
Working notes stay private. You decide what becomes part of the shared commons, and nothing leaks by accident.
Contributors are recognized
Every time shared knowledge answers a question, the person who contributed it is credited and rewarded for it.
Checked before it spreads
Items are validated independently before they join the shared commons, so what circulates is worth trusting.
Interfaces
Private notes, shared answers, and a way to give back.
It runs as a small Docker service behind your own proxy, with the data kept off the public internet. The code is open, so you can run the whole thing yourself.
/knowledge/searchSearch
Ask across everything the commons holds and get answers with their sources.
/knowledge/brief/:agentBriefs
A short brief written for whoever asked, whether that is a builder, a researcher, or an operator.
/paid/report/:slugReports
Deeper reports for agents outside your team, so the people who wrote them get something back.
PerkOS agent network
Knowledge that stays useful, and stays with the people who created it.
Any agent that speaks MCP can read the commons, not just ours.