experiment-log-action

A reusable composite GitHub Action that maintains a human-readable scientific experiment log (experiment-log.md) for any repository in the org. Each day, it synthesises repository activity (commits, issue comments, PR review comments, and discussions) into attribution-rich prose entries via Gemini, committed to a dedicated experiment-log branch and surfaced through a pull request to the repository's default branch.

Usage

Place the following workflow file in each target repository at .github/workflows/experiment-log.yml:

# Experiment Log Caller workflow - place this file in each target repository at .github/workflows/experiment-log.yml

name: Experiment Log Generator

on:
  schedule:
    - cron: '0 3 * * *'  # daily at 03:00 UTC
  workflow_dispatch:

concurrency:
  group: experiment-log
  cancel-in-progress: false

jobs:
  generate-log:
    runs-on: ubuntu-latest

    permissions:
      contents: write
      issues: read
      pull-requests: write
      discussions: read

    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run Experiment Log Action
        uses: 1712n/experiment-log-action@main
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          experiment_log_token: ${{ secrets.EXPERIMENT_LOG_TOKEN }}

Setup

EXPERIMENT_LOG_TOKEN (the Gemini API key) is stored as an organisation-level secret and is automatically available to all repositories in the org — no per-repo configuration required.