GitHub - Kyoto

Run Kyoto in GitHub Actions to get vibe checks on your pull requests — ensuring your project’s vibes are always on point.

Auto Setup
Manual Setup

Run the command below to setup the GitHub actions

kyoto setup github

Create a GitHub Actions workflow at .github/workflows/kyoto.yml

.github/workflows/kyoto.yml

name: Kyoto

on:
  push:
    branches:
      - main
  pull_request:

jobs:
  test:
    runs-on: ubuntu-latest
    permissions:
      checks: write
      contents: read
    env:
      KYOTO_TOKEN: ${{ secrets.KYOTO_TOKEN }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
      - run: npx @usekyoto/cli vibe check

GitHub Actions Secrets

Kyoto requires the KYOTO_TOKEN secret to run in GitHub Actions.

Go to your repository on GitHub
Navigate to Settings → Secrets and variables → Actions
Click “New repository secret”
Name: KYOTO_TOKEN
Call kyoto setup github to view the token value.

MCPTools for agents to vibe check themselves.

GitHub Actions Secrets