From 5c5463057ebdf057d00775a2ac5f17c68e54e86d Mon Sep 17 00:00:00 2001 From: tiennm99 Date: Mon, 10 Aug 2026 15:54:39 +0700 Subject: [PATCH] docs: point implementation cross-references at in-repo directories The three deployment variants now live in one repository: GitHub Actions at the root, the Go daemon under self-hosted/, the Worker under cloudflare-worker/. Update comparison tables, clone instructions, and the Go module path (binary builds as 'self-hosted'); GHCR image name is unchanged. --- README.md | 6 +++--- cloudflare-worker/README.md | 6 +++--- self-hosted/README.md | 8 ++++---- self-hosted/go.mod | 2 +- 4 files changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index a80b103..2bc52be 100644 --- a/README.md +++ b/README.md @@ -5,11 +5,11 @@ > > This repo is kept as a reference for anyone who still wants to fire routines from an external scheduler (GitHub Actions, own cron, Cloud Scheduler, etc.). > -> If you want **self-hosted scheduling with sub-second precision** (no GitHub cron delays/drops), see the sibling repo: [tiennm99/claude-code-routine-cron](https://github.com/tiennm99/claude-code-routine-cron) — Go daemon shipped as a multi-arch Docker image on GHCR. +> If you want **self-hosted scheduling with sub-second precision** (no GitHub cron delays/drops), see [`self-hosted/`](./self-hosted/) — Go daemon shipped as a multi-arch Docker image on GHCR (`ghcr.io/tiennm99/claude-code-routine-cron`). ## Choose your deployment -| | **claude-code-routine-trigger** (this) | [claude-code-routine-cron](https://github.com/tiennm99/claude-code-routine-cron) | [claude-code-routine-trigger-worker](https://github.com/tiennm99/claude-code-routine-trigger-worker) | +| | **GitHub Actions** (repo root) | [`self-hosted/`](./self-hosted/) | [`cloudflare-worker/`](./cloudflare-worker/) | | ---------------- | -------------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | Runs on | GitHub Actions runners | your infra (Docker, k8s, NAS, RPi) | Cloudflare edge | | Cost | free (within GitHub minutes) | minimal (your infra) | free (CF free tier) | @@ -17,7 +17,7 @@ | Setup | fork + 2 repo secrets | env vars + Docker | `wrangler deploy` + 2 secrets | | Audit trail | GitHub Actions runs page | container stdout | CF dashboard / `wrangler tail` | -Pick **this repo** if you want zero-infra and don't care about precise firing time. Pick **-cron** for behind-firewall / on-prem / precise timing. Pick **-worker** for edge-native deploys with CF dashboard observability. +Pick **GitHub Actions** if you want zero-infra and don't care about precise firing time. Pick **`self-hosted/`** for behind-firewall / on-prem / precise timing. Pick **`cloudflare-worker/`** for edge-native deploys with CF dashboard observability. Scheduled GitHub Actions workflow that fires a [Claude Code routine](https://code.claude.com/docs/en/routines) via the [`/fire` API](https://platform.claude.com/docs/en/api/claude-code/routines-fire). Ships with a 5×-daily default cron and exposes a `workflow_dispatch` button for on-demand runs. Fire URL and per-routine token live in repo secrets. diff --git a/cloudflare-worker/README.md b/cloudflare-worker/README.md index 33e963b..29d7e9f 100644 --- a/cloudflare-worker/README.md +++ b/cloudflare-worker/README.md @@ -46,7 +46,7 @@ Each fire shows up in *History* with status code and response body — open `cla ## Why this vs the siblings -| | [claude-code-routine-trigger](https://github.com/tiennm99/claude-code-routine-trigger) | [claude-code-routine-cron](https://github.com/tiennm99/claude-code-routine-cron) | **claude-code-routine-trigger-worker** (this) | +| | [GitHub Actions](../) (repo root) | [`self-hosted/`](../self-hosted/) | **cloudflare-worker** (this directory) | | ---------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------- | | Runs on | GitHub Actions runners | your infra (Docker host, k8s, NAS, RPi) | Cloudflare edge | | Cost | free (within GitHub minutes) | minimal (your infra) | free (CF free tier) | @@ -61,8 +61,8 @@ Each fire shows up in *History* with status code and response body — open `cla ### Quickstart ```bash -git clone https://github.com/tiennm99/claude-code-routine-trigger-worker -cd claude-code-routine-trigger-worker +git clone https://github.com/tiennm99/claude-code-routine-trigger +cd claude-code-routine-trigger/cloudflare-worker pnpm install # Upload secrets (from Anthropic routine editor → API trigger) diff --git a/self-hosted/README.md b/self-hosted/README.md index c31f54d..0db026c 100644 --- a/self-hosted/README.md +++ b/self-hosted/README.md @@ -9,7 +9,7 @@ Self-hosted Go daemon that fires a [Claude Code routine](https://code.claude.com ## Why this vs `claude-code-routine-trigger` -| | [claude-code-routine-trigger](https://github.com/tiennm99/claude-code-routine-trigger) | **claude-code-routine-cron** (this repo) | +| | [GitHub Actions](../) (repo root) | **self-hosted** (this directory) | | ---------------- | -------------------------------------------------------------------------------------- | ---------------------------------------- | | Runs on | GitHub Actions runners | your infra (Docker host, k8s, NAS, RPi) | | Cost | free (within GitHub minutes) | minimal (your infra) | @@ -113,10 +113,10 @@ The request pins `anthropic-beta: experimental-cc-routine-2026-04-01`. When Anth ## Build from source ```bash -git clone https://github.com/tiennm99/claude-code-routine-cron -cd claude-code-routine-cron +git clone https://github.com/tiennm99/claude-code-routine-trigger +cd claude-code-routine-trigger/self-hosted go build . -./claude-code-routine-cron # uses env vars from your shell +./self-hosted # uses env vars from your shell ``` Tests: diff --git a/self-hosted/go.mod b/self-hosted/go.mod index df55d96..2d03a77 100644 --- a/self-hosted/go.mod +++ b/self-hosted/go.mod @@ -1,4 +1,4 @@ -module github.com/tiennm99/claude-code-routine-cron +module github.com/tiennm99/claude-code-routine-trigger/self-hosted go 1.22