From f21c8f46b628f6c83a4e249105f0dfd0fc3d0909 Mon Sep 17 00:00:00 2001
From: decentral1se <cellarspoon@riseup.net>
Date: Mon, 16 Feb 2026 10:08:36 +0100
Subject: [PATCH] docs: moar help for manual CI runs

---
 docs/abra/hack.md | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/docs/abra/hack.md b/docs/abra/hack.md
index dfcd07a..eac9b95 100644
--- a/docs/abra/hack.md
+++ b/docs/abra/hack.md
@@ -121,7 +121,27 @@ cd
 ./run-ci-int
 ```
 
-You can also `cd abra` and run `bats ...` directly to trigger specific subsets of tests. See below for more tips.
+You can also `cd abra` and run `bats ...` directly to trigger specific subsets
+of tests. You'll need to export the env vars at the bottom of the `run-ci-int`
+script to reproduce the same settings.
+
+```
+export ABRA_DIR="$HOME/.abra_test"
+export TERM=xterm
+export TEST_SERVER=default
+export ABRA_CI=1
+```
+
+And then ensuring a clean state and running with the same flags:
+
+```
+rm -rf "$ABRA_DIR"
+bats -Tp tests/integration --filter-tags \!dns --print-output-on-failure
+```
+
+See the [`run-ci-int`](https://git.coopcloud.tech/toolshed/abra/src/branch/main/scripts/tests/run-ci-int) script for more.
+
+See below for more tips on how to run the tests.
 
 ### Running them locally