Skip to content

Commit 876bf18

Browse files
fix: add C++20 flags to binding.gyp for Node.js 24 compatibility
1 parent 342ea6b commit 876bf18

2 files changed

Lines changed: 44 additions & 0 deletions

File tree

apps/docs/docs/getting-started/installation.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,41 @@ nvm use 18.20.8
101101

102102
- **Pre-commit hooks** are configured via Husky and lint-staged. They run automatically on staged files when you commit.
103103

104+
## Troubleshooting
105+
106+
### Build fails on Node.js 24 with "C++20 or later required"
107+
108+
Node.js 24 upgraded its V8 headers to require C++20. If you see errors like:
109+
110+
```
111+
error: C++20 or later required.
112+
error: unknown type name 'concept'
113+
```
114+
115+
This was caused by `binding.gyp` not specifying the C++ standard for the native tree-sitter binding. It is fixed in the current codebase. If you encounter it, make sure you are on the latest `main` branch:
116+
117+
```bash
118+
git pull origin main
119+
pnpm install
120+
pnpm build
121+
```
122+
123+
As a temporary workaround on older checkouts:
124+
125+
```bash
126+
CXXFLAGS="-std=c++20" pnpm install
127+
```
128+
129+
### `@agentscript/agentforce` not found on npm
130+
131+
The package is published as part of the monorepo build. If you see "package not found" errors during install, run a full build first:
132+
133+
```bash
134+
pnpm build
135+
```
136+
137+
If you are trying to use the package as a consumer (outside this repo), check the [npm registry](https://www.npmjs.com/search?q=%40agentscript) for the latest published version — publishing cadence may lag behind `main`.
138+
104139
## Next Steps
105140

106141
- [Quickstart](/getting-started/quickstart) -- Build the project and explore the structure.

packages/parser-tree-sitter/binding.gyp

Lines changed: 9 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)