Skip to content

Geocodio/yak

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

597 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Yak mascot

Yak

Yak is an autonomous coding agent for papercuts, a line-by-line PR reviewer, and a per-branch preview server. One shared sandbox fleet powers all three workflows.

MIT License · Contributing · Documentation


What It Does

  • Opens PRs for papercuts. Receives tasks from Slack, Linear, Sentry, and GitHub; sends Claude into an isolated sandbox; opens a reviewable PR and verifies CI passes
  • Reviews pull requests. Line-level comments, suggestion blocks, and a feedback dashboard
  • Serves preview deployments. Every open PR gets a unique URL, OAuth-gated, hibernated when idle, destroyed when the PR closes
  • Shared sandbox fleet. One Incus + ZFS substrate, one GitHub App, one Livewire dashboard, one cost model across all three workflows

How It Works

Yak picks up tasks from Slack, Linear, and Sentry and delivers pull requests

Quick Start

See the Setup Guide for provisioning a fresh server with Ansible, or the Development Guide for running Yak locally.

Channel Support

Channel Input (receive tasks) Notifications (send updates)
Slack Yes Yes
Linear Yes Yes
Sentry Yes --
GitHub Yes (PR review events) Yes (PR reviews, comments)

Design Philosophy

  • Laravel-native -- built on Laravel 13, Livewire 4, and Flux UI.
  • Channel-agnostic -- driver-based architecture makes it easy to add new input and notification channels.
  • State machine driven -- every task follows a defined lifecycle with explicit transitions.
  • AI-assisted, human-supervised -- tasks are automated but observable through the dashboard and notifications.

Documentation

Full documentation is hosted at geocodio.github.io/yak.

Contributing

We welcome contributions! Please read our Contributing Guide to get started.

License

Yak is open-sourced software licensed under the MIT license.

Copyright 2026 Geocodio

About

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.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors