Skip to content

docs: add Agent Hooks plugin page - #3043

Open
LeonSGP43 wants to merge 1 commit into
headroomlabs-ai:mainfrom
LeonSGP43:docs/agent-hooks-page
Open

docs: add Agent Hooks plugin page#3043
LeonSGP43 wants to merge 1 commit into
headroomlabs-ai:mainfrom
LeonSGP43:docs/agent-hooks-page

Conversation

@LeonSGP43

@LeonSGP43 LeonSGP43 commented Aug 15, 2026

Copy link
Copy Markdown

Description

Adds docs/content/docs/agent-hooks.mdx and registers it in the Integrations nav. plugins/headroom-agent-hooks (auto-start hooks for Claude Code / Copilot CLI) ships with an 11-line README and zero docs-site coverage. Documented from the plugin source (hooks/hooks.json, .claude-plugin/plugin.json, .github/plugin/plugin.json).

Type of Change

  • Documentation update

Changes Made

  • Added docs/content/docs/agent-hooks.mdx: what headroom init hook ensure does, supported hosts (Claude Code / Copilot CLI), install steps, and how to verify hooks are active.
  • Registered the page in docs/content/docs/meta.json Integrations nav.

Testing

  • Unit tests pass (pytest)
  • Linting passes (ruff check .)
  • Type checking passes (mypy headroom)
  • New tests added for new functionality
  • Manual testing performed

Test Output

# Docs-only change: no Python surface touched, so pytest/ruff/mypy are unaffected.
# Manual checks performed:
#   - new page frontmatter/title matches sibling Integrations pages
#   - docs/content/docs/meta.json remains valid JSON with the new nav entry
#   - markdown links resolve to existing docs pages

Real Behavior Proof

  • Environment: local checkout of main + branch
  • Exact command / steps: inspected docs/content/docs/meta.json after edit (valid JSON, nav ordering correct); diffed the new page's frontmatter against sibling integration pages
  • Observed result: page follows the same MDX structure and renders in the expected Integrations section
  • Not tested: full fumadocs site build (requires Node install); content is plain MDX consistent with existing pages

Runtime Rollout Safety

  • Rollout-managed feature(s): none — documentation only
  • Minimum rollout channel: N/A
  • Stable/default behavior changed: none
  • Kill switch / disable path: N/A
  • Unsafe override required: none
  • Qualification impact: none
  • Rollback path: revert the commit(s) on this branch

Review Readiness

  • I have performed a self-review
  • This PR is ready for human review

Checklist

  • My code follows the project's style guidelines
  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • My changes generate no new warnings
  • I did not edit CHANGELOG.md — it is generated by release-please from my Conventional Commit PR title

Additional Notes

Docs-only PR: pytest/ruff/mypy items intentionally unchecked (no Python code changed).

Add docs/content/docs/agent-hooks.mdx covering the bundled
plugins/headroom-agent-hooks startup hooks for Claude Code and
GitHub Copilot CLI: the headroom init hook ensure helper, the
SessionStart / PreToolUse hook table with matchers and timeouts,
and the two plugin manifests. Register the page in nav.

Signed-off-by: LeonSGP43 <LeonSGP43@users.noreply.github.com>
@github-actions

github-actions Bot commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

PR governance

This PR follows the template and is marked ready for human review.

@github-actions github-actions Bot added status: needs author action Pull request body or readiness checklist still needs author updates status: ready for review Pull request body is complete and the author marked it ready for human review and removed status: needs author action Pull request body or readiness checklist still needs author updates labels Aug 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status: ready for review Pull request body is complete and the author marked it ready for human review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant