Receives tasks
From Slack @mentions, Linear yak labels, Sentry alerts, or the manual CLI.
Every integration is a pluggable channel — enable only what you use.
Yak
Yak is an autonomous coding agent for papercuts. It picks up small tasks from Slack, Linear, Sentry, and GitHub and delivers reviewable pull requests while you work on what matters.
What Yak does
Section titled “What Yak does”Fixes papercuts
Bug fixes, flaky tests, lint violations, deprecation cleanups. Tasks where the fix is small and focused, and the description is under a paragraph.
Opens pull requests
Screenshots and video walkthroughs for UI changes. A human reviews every PR before merge. Yak has no merge authority. No exceptions.
Responds where asked
Slack message → Slack thread reply. Linear issue → Linear comment. You never have to check a separate UI to see what happened.
Explore the docs
Section titled “Explore the docs”Setup Guide
Provision a fresh server with one Ansible command. Vault configuration, verification, updates. Read the setup guide
Channels
Slack, Linear, Sentry, GitHub, Drone, and the manual CLI. Per-channel setup and gotchas. See channel configuration
Architecture
Two-tier AI, channel drivers, state machine, queues and jobs, safety model. Read the architecture guide
Prompting
Three prompt layers, the Yak system prompt, task templates per source, MCP servers. Customize Yak’s behavior
Design philosophy
Section titled “Design philosophy”- One-shot by design. A task fits in a paragraph. Yak resolves it in a single pass. If it needs back-and-forth, it’s not a Yak task.
- Meet the user where they are. Slack in, Slack out. Linear in, Linear out. No separate dashboard check required.
- Clarify, don’t guess. Ambiguous requests get multiple-choice options grounded in actual code, not generic guesses.
- Yak never ships. Output is always a PR requiring human review. No merge authority, no exceptions.
- Channels are optional. GitHub plus the manual CLI is the minimum. Enable the rest as you need them.