Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
Every GitHub feature, URL trick, keyboard shortcut, search qualifier, Actions pattern and power-user tool worth knowing. Each one verified against the source, with the trap that nobody else writes down.
Saved setup from 9 h ago
Will it work on macOS?
your repository, and what it does behind your back
<sub>CAPITALS are placeholders to replace · Amey-Thakur/GITHUB-TRICKS is this repository, swap in your own · {owner} in a gh command is literal</sub>
/docs/ @team recursive
docs/* @team ONE level deep, and nothing warns you
<br>[!CAUTION] Last match wins, not most specific. A
* @org/everyonecatch-all at the bottom, which reads like a sensible fallback, disables every rule above it.Invalid lines are skipped silently. A team without write access is dropped silently. The file is read from the base branch, so a pull request that adds itself as an owner cannot apply that rule to itself.
[!CAUTION] A required check skipped by path filtering blocks the pull request forever. Skipped is not passed, and no timeout converts one into the other. Fix it with a second workflow of the same job name, on the complementary paths, that exits 0.
A merge queue stalls silently unless every required workflow listens for it:
on:
merge_group:
Fixes owner/repo#100 closes an issue in another repository, but is ignored unless the pull request targets the default branch. Open as a draft to defer code-owner pings until you are ready.
.github/release.yml shapes autogenerated release notes. * is the catch-all, and categories are evaluated in order.CNAME entirely. Set the custom domain in Settings; a generator that writes CNAME into the build does nothing..nojekyll, or lose your build. Without it Jekyll deletes every directory starting with an underscore, which means _next, _app and _assets.| Symptom | Cause | Fix |
|---|---|---|
| A workflow never fires after another one pushed | GITHUB_TOKEN actions do not trigger workflows | Use an App token or a PAT |
| if: fires on "false" | github.event.inputs turns booleans into strings | Use the inputs context |
| actions/checkout suddenly 403s | Naming one permission sets every other to none | List contents: read as well |
| The cron stopped months ago | Public repos disable schedules after 60 days idle | Push anything, or re-enable in Actions |
| The cache never warms on a pull request | Untrusted triggers get a read-only cache token | No opt-out. Warm it on the default branch |
| Every new branch builds slowly | Caches do not cross sibling branches | Build the cache on the default branch |
| A matrix job's output vanished | Every leg writes the same key, last wins | Use artifacts instead |
| An output disappeared with no error | It resembled a secret and was masked | Look for the skip warning in the log |
| workflow_run linted the wrong code | It runs on the default branch | Check out the triggering SHA explicitly |
on:
workflow_dispatch:
inputs:
environment:
type: choice # real form controls on manual runs
options: [staging, production]
concurrency:
group: deploy
queue: max # queue up to 100 instead of cancelling
steps:
- run: make assets
background: true # parallel steps in one job, added June 2026
- wait
- run: echo "### Report" >> "$GITHUB_STEP_SUMMARY"
Set a repository variable ACTIONS_STEP_DEBUG to true for debug logs without touching the YAML. Run workflows locally with act, which ignores concurrency and permissions. Audit them with zizmor, and type-check expressions with actionlint.
[!CAUTION]
pull_request_targetplus a checkout of the pull request head. The job runs with your secrets and a write token, then executes a stranger'spostinstallscript. Nothing in the diff has to look malicious.From 2 December 2026 GitHub Actions blocks
pull_request_targetby default in every public repository, unless an Actions event policy allows it. That closes the default case, not the one you re-enable.
${{ github.event.* }}insiderun:. Substitution happens before the shell ever sees the line, so quoting does not save you.
- env:
TITLE: ${{ github.event.pull_request.title }} # safe: data, not script
run: ech
…
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/Amey-Thakur/GITHUB-TRICKS.git cd GITHUB-TRICKS
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
/docs/ @team recursive docs/* @team ONE level deep, and nothing warns you gh attestation verify ./app -R OWNER/REPO \ --signer-workflow OWNER/REPO/.github/workflows/release.yml
No reports for macOS yet.
GitManual AI Agent reads the 2 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.