Skip to content

README.md

Latest commit

 

History

History
48 lines (33 loc) · 1.82 KB

README.md

File metadata and controls

48 lines (33 loc) · 1.82 KB
Raw

Hive Commons Documentation

Hive Commons Logo

Documentation for the Hive Commons projects

Official documentation site for Hive Commons, served at docs.hivecommons.dev. It covers:

  • Hive — autonomous AI agent fleets for your repositories
  • hotshot — screenshots straight into your AI coding terminal
  • pluk — pub-sub event streaming for AI agent tmux sessions
  • rationguard — detect and rebut rationalization patterns in AI agent output
  • promptargs — template expansion for AI prompts

How content is sourced

Hive, hotshot, and pluk docs are single-sourced from their repositories and pulled at build time:

  • scripts/sync-hive-docs.ts pulls Hive docs from hivecommons/hive (src/docs/, branch v4; override with HIVE_DOCS_OWNER / HIVE_DOCS_REPO / HIVE_DOCS_REF).
  • scripts/sync-sibling-docs.ts pulls the hotshot, pluk, rationguard, and promptargs docs from their repos.

Edit the canonical source in the project repository — not the synced copies under docs/content/. If a sync source is unreachable at build time, the committed copies are used as a fallback.

Development

npm install
npm run dev        # http://localhost:3000

The site is Next.js + Nextra, deployed on Netlify (site hivecommons-docs). Navigation is defined in src/app/docs/page-map.ts; project registry in src/config/versions.ts.

Contributing

PRs welcome. Sign your commits (DCO): git commit -s.

License

Apache 2.0