Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

fix(setup-dev): stop the dev setup from replacing the mandated pre-push hook

nirholasd7a436e3aa3e
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 82c606138..d565a2ae0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -35,9 +35,11 @@ Open [http://localhost:3000](http://localhost:3000) and verify the default model
`npm run setup` finishes what `npm install` can't: it builds the local
`solana-agent-sdk` (linked as a `file:` dependency, ships no prebuilt `dist/`)
and generates the gitignored `data/_generated/*` artifacts that the app,
-sitemap, and test suite read. It also activates the repo's pre-push hook
-(`.githooks/pre-push`), which runs `npm run typecheck` before every push.
-It is idempotent — re-running it skips anything already up to date.
+sitemap, and test suite read. It also installs the repo's pre-push hook into
+`.git/hooks`, which checks the commits you are pushing (and only those) against
+the hard rules in `CLAUDE.md` and refuses to push credential material or a
+generic commit subject. It is idempotent: re-running it skips anything already
+up to date.
---
diff --git a/scripts/setup-dev.mjs b/scripts/setup-dev.mjs
index aa7d5df1a..56d1b7540 100644
--- a/scripts/setup-dev.mjs
+++ b/scripts/setup-dev.mjs
@@ -54,9 +54,17 @@ if (!existsSync(resolve(ROOT, 'agent-payments-sdk/dist/index.js'))) {
buildSdk('setup-agent-payments-sdk', 'agent-payments-sdk', 'agent-payments-sdk/dist/index.js');
}
-// 2. Git hooks: no CI runs on this repo, so the pre-push typecheck in
-// .githooks/ is the only automated gate before the Vercel build.
-run('git config core.hooksPath .githooks');
+// 2. Git hooks. The pre-push hook lives in .git/hooks and is installed by
+// scripts/setup-git-hooks.mjs (postinstall runs it too); it enforces the
+// CLAUDE.md hard rules and the no-credentials rule on exactly the commits
+// being pushed. An earlier version of this script pointed core.hooksPath at a
+// separate .githooks/ directory, which silently REPLACED that hook with a
+// typecheck-only one on every machine that ran setup, so the mandated checks
+// never fired for anyone who followed the contributor docs. Undo that
+// redirect where it is still set, then (re)install the real hook.
+const hooksPath = run('git config --get core.hooksPath', { allowFail: true }).trim();
+if (hooksPath === '.githooks') run('git config --unset core.hooksPath');
+run('node scripts/setup-git-hooks.mjs');
// 3. Generated data consumed by the app, sitemap, and tests.
run('node scripts/build-news.mjs');