
Setting Up Relayfile
Walks you through mounting cloud providers like Notion, Linear, and GitHub as local files so agents can read and write through normal filesystem operations instead of API calls. The setup flow handles OAuth, backend selection between Nango and Composio, Atlassian site picking for Jira/Confluence, and mount verification. What I like is the detail on writeback debugging: it covers dead letter queues, retry commands, and permission denials, which is exactly where these integrations break in practice. The skill also emphasizes reading provider-specific layout files instead of hardcoding paths, which is the right move given how often these schemas drift. Best for anyone handing filesystem access to an agent that needs to modify external resources.
- GitHub stars
- 719
- last updated
- Jun 11, 2026
Install
$ npx -y skills add agentworkforce/relay --skill setting-up-relayfile --agent claude-codeInstalls into .claude/skills of the current project.
Files
Overview
Relayfile mounts a provider (Notion, Linear, Slack, GitHub, and other adapter-backed integrations) as ordinary files on disk so an agent can read and write through the filesystem instead of calling APIs. This skill is the canonical setup recipe. Follow it top-to-bottom for first-time setup; jump to Recovering from breakage if a working mount has gone wrong.
When to use this skill
- An agent needs read access to a provider (e.g., "summarize this Notion database").
- An agent needs to write back to a provider (e.g., "post a review on this Notion page", "update this Linear issue").
- A human is setting up a mount before delegating work to an agent.
- A mount stopped reflecting changes and you need to diagnose where.
What you get
After setup, files appear under <local-dir>/<provider>/...:
Sponsors
Details
- Repository
- github.com/agentworkforce/relay
- Categories
- Git & Pull Requests, Cloud & Infrastructure, Office & Documents
- License
- Apache-2.0
- First seen
- Jun 11, 2026
More from agentworkforce/relay
All 18- Using Agent Relay
- Writing Agent Relay Workflows
- Browser Testing With Screenshots
- Choosing Swarm Patterns
- Creating Agent Skills Skill
- Creating Claude Agents
- Creating Claude Hooks
- Creating Claude Rules
- Creating Skills
- Debugging Websocket Issues
- Deploying To Staging Environment
- Frontend Design
- Github Oauth Nango Integration
- Implementing Command Palettes
- Prpm Json Best Practices
- Relay 80 100 Workflow
- Review Fix Signoff Loop