Connect your sources
A source is a system Halyard ingests from. Connecting one tells Halyard where your team’s work happens so it can fill the knowledge layer without anyone maintaining a separate wiki. You connect sources in the Halyard app under Settings → Integrations — this is org setup in the web UI, not MCP client config.
Before you connect anything, know the one distinction that decides what a source is good for.
Knowledge vs work events
Section titled “Knowledge vs work events”Halyard stores two kinds of memory, and a source produces one or the other:
- Knowledge is searchable, narrative, and summarized — past decisions, answers, and work outputs an agent can find with a semantic query. Slack produces knowledge (captured expert answers) and routes questions to humans.
- Work events are an episodic metrics ledger — “PR #457 merged”, “issue moved to In Progress”, “calendar event created”. They are not semantically searchable; you list and filter them by type, author, and time. GitHub, Linear, ClickUp, and Google Calendar all produce work events.
If you connect a source expecting your agents to search its contents, check this column first. A merged PR or a calendar invite is a work event — it shows up in activity feeds and delivery metrics, not in a knowledge search. See Knowledge vs work events for the full model.
Source matrix
Section titled “Source matrix”| Source | Status | Mechanism | Produces |
|---|---|---|---|
| Slack | Live | Event-driven (no backfill) | Expert routing + captured knowledge |
| GitHub | Live | Webhooks + 90-day backfill | Work events (PRs, reviews) |
| ClickUp | Live | Webhooks + 90-day backfill | Work events (tasks) |
| Linear | Live (partial) | Webhooks only, no backfill | Work events (issues) |
| Google Calendar | Live | Per-user OAuth backfill sync | Work events (meetings) |
| Agent sessions (Claude / Cursor / Codex) | Live | Halyard CLI sync / push | Knowledge (work outputs) |
Agent sessions are connected through the Halyard CLI, not the Integrations screen — the CLI pushes your AI coding session logs into the knowledge layer.
Pick a source
Section titled “Pick a source”- Slack — the human side of the loop: route questions to experts and capture their answers as knowledge.
- GitHub — PRs and reviews as delivery work events.
- ClickUp — tasks as work events, with backfill.
- Linear — issues as work events (webhooks only, no history).
- Google Calendar — meetings as work events; the meetings story today.