{"owner":"HackTricks-wiki","repo":"hacktricks","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# AGENTS.md\n\nGuidance for future agents working in this repository.\n\n## Repository Context\n\nThis is the main HackTricks mdBook repository. The related cloud book lives at:\n\n`/Users/carlospolop/git/hacktricks-cloud`\n\nChanges to shared theme/search behavior often need to be applied in both repositories.\n\n## Search Index Loading Contract\n\nThe custom search UI lives in:\n\n`theme/ht_searcher.js`\n\nThere may also be a generated copy at:\n\n`book/theme/ht_searcher.js`\n\nIf production is deploying the already-built `book/` directory, update both copies or rebuild the\nbook before deployment.\n\nThe search index loading order is important and cost-sensitive:\n\n1. Load every language-specific and fallback search index from the GitHub repository:\n   `HackTricks-wiki/hacktricks-searchindex`\n2. Only if all GitHub-hosted candidates fail, fall back to the same-origin mdBook output.\n\nDo not place the local `/searchindex.js` fallback before any GitHub-hosted fallback such as\n`searchindex-en.js.gz`. Serving `searchindex.js` from `hacktricks.wiki` in production is expensive.\n\nFor this repo, the expected local fallback is:\n\n`/searchindex.js`\n\nThe cloud index should not use a local fallback from this origin. It should rely on the remote\n`searchindex-cloud-<lang>.js.gz` files.\n\n## Search Index Publishing\n\nThe workflows that publish encrypted compressed search indexes to\n`HackTricks-wiki/hacktricks-searchindex` are:\n\n- `.github/workflows/build_master.yml`\n- `.github/workflows/translate_all.yml`\n\nThe generated source file is `book/searchindex.js`. The published remote artifact names are:\n\n- `searchindex-en.js.gz`\n- `searchindex-<lang>.js.gz`\n\nThe browser loader expects the remote `.js.gz` files to be XOR-encrypted gzip payloads using the\nkey defined in `theme/ht_searcher.js`.\n\n## Build And Validation\n\nCommon local checks:\n\n- `node --check theme/ht_searcher.js`\n- `mdbook build`\n\nIf `mdbook build` fails, check:\n\n- `hacktricks-preprocessor-error.log`\n- `hacktricks-preprocessor.log`\n\n## Editing Notes\n\n- Prefer `rg` for searching.\n- Keep generated `book/` output out of commits unless explicitly requested. Search loader fixes are\n  an exception when the already-built pages must be corrected immediately.\n- If changing shared theme behavior, compare and update the matching file in\n  `/Users/carlospolop/git/hacktricks-cloud`.\n- Do not revert unrelated local changes.\n"},"files":{"AGENTS.md":"# AGENTS.md\n\nGuidance for future agents working in this repository.\n\n## Repository Context\n\nThis is the main HackTricks mdBook repository. The related cloud book lives at:\n\n`/Users/carlospolop/git/hacktricks-cloud`\n\nChanges to shared theme/search behavior often need to be applied in both repositories.\n\n## Search Index Loading Contract\n\nThe custom search UI lives in:\n\n`theme/ht_searcher.js`\n\nThere may also be a generated copy at:\n\n`book/theme/ht_searcher.js`\n\nIf production is deploying the already-built `book/` directory, update both copies or rebuild the\nbook before deployment.\n\nThe search index loading order is important and cost-sensitive:\n\n1. Load every language-specific and fallback search index from the GitHub repository:\n   `HackTricks-wiki/hacktricks-searchindex`\n2. Only if all GitHub-hosted candidates fail, fall back to the same-origin mdBook output.\n\nDo not place the local `/searchindex.js` fallback before any GitHub-hosted fallback such as\n`searchindex-en.js.gz`. Serving `searchindex.js` from `hacktricks.wiki` in production is expensive.\n\nFor this repo, the expected local fallback is:\n\n`/searchindex.js`\n\nThe cloud index should not use a local fallback from this origin. It should rely on the remote\n`searchindex-cloud-<lang>.js.gz` files.\n\n## Search Index Publishing\n\nThe workflows that publish encrypted compressed search indexes to\n`HackTricks-wiki/hacktricks-searchindex` are:\n\n- `.github/workflows/build_master.yml`\n- `.github/workflows/translate_all.yml`\n\nThe generated source file is `book/searchindex.js`. The published remote artifact names are:\n\n- `searchindex-en.js.gz`\n- `searchindex-<lang>.js.gz`\n\nThe browser loader expects the remote `.js.gz` files to be XOR-encrypted gzip payloads using the\nkey defined in `theme/ht_searcher.js`.\n\n## Build And Validation\n\nCommon local checks:\n\n- `node --check theme/ht_searcher.js`\n- `mdbook build`\n\nIf `mdbook build` fails, check:\n\n- `hacktricks-preprocessor-error.log`\n- `hacktricks-preprocessor.log`\n\n## Editing Notes\n\n- Prefer `rg` for searching.\n- Keep generated `book/` output out of commits unless explicitly requested. Search loader fixes are\n  an exception when the already-built pages must be corrected immediately.\n- If changing shared theme behavior, compare and update the matching file in\n  `/Users/carlospolop/git/hacktricks-cloud`.\n- Do not revert unrelated local changes.\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# AGENTS.md\n\nGuidance for future agents working in this repository.\n\n## Repository Context\n\nThis is the main HackTricks mdBook repository. The related cloud book lives at:\n\n`/Users/carlospolop/git/hacktricks-cloud`\n\nChanges to shared theme/search behavior often need to be applied in both repositories.\n\n## Search Index Loading Contract\n\nThe custom search UI lives in:\n\n`theme/ht_searcher.js`\n\nThere may also be a generated copy at:\n\n`book/theme/ht_searcher.js`\n\nIf production is deploying the already-built `book/` directory, update both copies or rebuild the\nbook before deployment.\n\nThe search index loading order is important and cost-sensitive:\n\n1. Load every language-specific and fallback search index from the GitHub repository:\n   `HackTricks-wiki/hacktricks-searchindex`\n2. Only if all GitHub-hosted candidates fail, fall back to the same-origin mdBook output.\n\nDo not place the local `/searchindex.js` fallback before any GitHub-hosted fallback such as\n`searchindex-en.js.gz`. Serving `searchindex.js` from `hacktricks.wiki` in production is expensive.\n\nFor this repo, the expected local fallback is:\n\n`/searchindex.js`\n\nThe cloud index should not use a local fallback from this origin. It should rely on the remote\n`searchindex-cloud-<lang>.js.gz` files.\n\n## Search Index Publishing\n\nThe workflows that publish encrypted compressed search indexes to\n`HackTricks-wiki/hacktricks-searchindex` are:\n\n- `.github/workflows/build_master.yml`\n- `.github/workflows/translate_all.yml`\n\nThe generated source file is `book/searchindex.js`. The published remote artifact names are:\n\n- `searchindex-en.js.gz`\n- `searchindex-<lang>.js.gz`\n\nThe browser loader expects the remote `.js.gz` files to be XOR-encrypted gzip payloads using the\nkey defined in `theme/ht_searcher.js`.\n\n## Build And Validation\n\nCommon local checks:\n\n- `node --check theme/ht_searcher.js`\n- `mdbook build`\n\nIf `mdbook build` fails, check:\n\n- `hacktricks-preprocessor-error.log`\n- `hacktricks-preprocessor.log`\n\n## Editing Notes\n\n- Prefer `rg` for searching.\n- Keep generated `book/` output out of commits unless explicitly requested. Search loader fixes are\n  an exception when the already-built pages must be corrected immediately.\n- If changing shared theme behavior, compare and update the matching file in\n  `/Users/carlospolop/git/hacktricks-cloud`.\n- Do not revert unrelated local changes.\n","category":"root","tokens":592}]}