Connectors

Connectors let the workspace Researcher use selected external sources while answering questions in a channel. GitHub and Linear are read-only: agents cannot change a repository, create a ticket, or update an issue.

GitHub

Use GitHub when you want answers about code, pull requests, issues, releases, or recent shipped work in a repository.

Connect GitHub

1. Open Settings → Connectors.
2. Create a fine-grained GitHub personal access token with read-only access to Pull requests, Issues, Contents, and Metadata.
3. Paste the token and enter each repository as owner/repo, one per line.
4. Select Validate & Save.

The token is validated before Woodstock saves the connection. Agents can only read the repositories in this list. To change the list or remove access, disconnect GitHub and connect it again with the new scope.

Ask about GitHub

Ask the Researcher in a channel, for example:

What shipped recently in tinkerslabs/woodstock?

Find the pull request that added the GitHub connector and summarize it.

Available GitHub tools

• github_list_recent — lists recently updated pull requests and issues in the approved repositories.
• github_search_prs — searches approved repositories for a pull request or issue by keyword.
• github_get_pr — reads the title, state, description, and link for one pull request or issue.

Linear

Use Linear when you want to know what a team is working on, what is in progress, or which recent issues relate to a question.

Connect Linear

1. Open Settings → Connectors and select Connect Linear.
2. Authorize Woodstock in Linear.
3. Return to Woodstock, select I've authorized — continue, then choose the Linear teams the Researcher may read.
4. Select Save scope.

The connection only exposes recent issues from the selected teams. Disconnecting Linear removes that access.

Ask about Linear

Ask the Researcher in a channel, for example:

What is the team working on this week?

Show me the recent in-progress work for our product team.

Available Linear tool

• linear_list_recent — lists recently updated issues from the selected teams, including each issue’s identifier, title, state, and link.

What is not available yet

Slack, Google Drive, and Notion are not connected to Woodstock yet. Connectors also do not currently let agents write back to GitHub or Linear.

Once connected, ask an agent about information in that approved source from a channel.