Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions llms.txt
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ Crux is the agent runtime taken from Hive. Use it without Hive to start agents,

Hive Commons also maintains Spektacular (Spek), a spec-driven workflow tool; the specs it produces are called speks.

Video: [How Hive works](https://www.youtube.com/watch?v=uo1KGTyJJyU)

## Projects

- [Hive](https://github.com/hivecommons/hive): control layer for governed, audited fleets of AI coding agents. Docs: https://docs.hivecommons.dev
Expand All @@ -17,6 +19,21 @@ Hive Commons also maintains Spektacular (Spek), a spec-driven workflow tool; the
- [rationguard](https://github.com/hivecommons/rationguard): detects and rebuts rationalization patterns in AI agent output.
- [dibs](https://dibs.hivecommons.dev): contributor attribution layer for the AI-agent era, connecting ideators with hive-managed repositories.

## Adopters

KubeStellar Console, tunaos.org and Project Bluefin run Hive in production; Frostyard, Open Horizon, Open Horizon Services and Danathar are pre-production adopters. Full list: [ADOPTERS.md](https://github.com/hivecommons/hive/blob/HEAD/ADOPTERS.md)

## Community

- [Join the mailing list](https://hivecommons.dev/join)
- [Chat on Discord](https://hivecommons.dev/discord)
- [Watch the hive live on Twitch](https://hivecommons.dev/twitch)
- [Biweekly meeting, Thursdays 10:00 AM ET](https://hivecommons.dev/meet)
- [Agenda and notes](https://hivecommons.dev/agenda)
- [Meeting recordings](https://hivecommons.dev/tv)
- [Documentation](https://docs.hivecommons.dev)
- [Governance, maintainers, and security policy](https://github.com/hivecommons/.github/blob/HEAD/GOVERNANCE.md)

## Supported agents and inference engines

Hive supports agent CLIs including Claude Code, GitHub Copilot CLI, Goose, OpenAI Codex CLI, Pi, IBM Bob, Aider, Gemini CLI, Google Antigravity CLI, OpenCode, Kilo Code, Muse Code and Oh My Pi.
Expand Down
53 changes: 53 additions & 0 deletions scripts/llms-txt.test.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -159,6 +159,34 @@ function assertSameSet(pageNames, llmsNames, what) {
);
}

// Absolute URLs llms.txt must carry for the home page's community surface:
// every "Join in" link in #community, the ADOPTERS.md link and the
// "See how Hive works" video. Root-relative hrefs resolve against SITE.
const SITE = "https://hivecommons.dev";

export function absolutize(href) {
return href.startsWith("/") ? SITE + href : href;
}

export function communityHrefs(html) {
const s = html.indexOf('id="community"');
if (s < 0) return [];
const start = html.indexOf("<h3>Join in</h3>", s);
const end = html.indexOf("</ul>", start);
if (start < 0 || end < 0) return [];
return [...html.slice(start, end).matchAll(/<a\b[^>]*\bhref="([^"]+)"/g)].map((m) => absolutize(decode(m[1])));
}

export function adoptersHref(html) {
const m = html.match(/<a href="([^"]+\/ADOPTERS\.md)"/);
return m ? decode(m[1]) : null;
}

export function videoHref(html) {
const m = html.match(/<a class="inline-link" href="([^"]+)">[^<]*See how Hive works/);
return m ? decode(m[1]) : null;
}

// --- fixture self-tests ------------------------------------------------------

test("splitProseList handles Oxford and non-Oxford lists, 'and', and single items", () => {
Expand Down Expand Up @@ -318,6 +346,20 @@ test("fixture: cruxVersionFromLlms extracts version from llms.txt or returns nul
assert.equal(cruxVersionFromLlms(""), null);
});

test("community link extractors read Join in, ADOPTERS.md and video hrefs", () => {
const html = `<a class="inline-link" href="https://v.example/x">Prefer to watch? See how Hive works</a>
<p>Listed in <a href="https://g.example/ADOPTERS.md">ADOPTERS.md</a>.</p>
<section id="community"><a href="/ignored">x</a><h3>Join in</h3><ul>
<li><a href="/join">m</a></li><li><a href="https://docs.example">d</a></li></ul></section>`;
assert.deepEqual(communityHrefs(html), ["https://hivecommons.dev/join", "https://docs.example"]);
assert.equal(adoptersHref(html), "https://g.example/ADOPTERS.md");
assert.equal(videoHref(html), "https://v.example/x");
assert.deepEqual(communityHrefs("<p>none</p>"), []);
assert.deepEqual(communityHrefs('<section id="community"><h3>Other</h3></section>'), []);
assert.equal(adoptersHref("<p>none</p>"), null);
assert.equal(videoHref("<p>none</p>"), null);
});

// --- live checks -------------------------------------------------------------

const live = parseLlmsTxt(LLMS_TXT);
Expand Down Expand Up @@ -420,3 +462,14 @@ test("hotshot JSON-LD featureList names every released target CLI and the Homebr
"hotshot JSON-LD featureList omits the Homebrew install",
);
});

test("llms.txt carries every Join in link, the ADOPTERS.md link and the How Hive works video from index.html", () => {
const hrefs = communityHrefs(INDEX_HTML);
assert.ok(hrefs.length > 0, "index.html lost its #community 'Join in' list");
const adopters = adoptersHref(INDEX_HTML);
assert.ok(adopters, "index.html lost its ADOPTERS.md link");
const video = videoHref(INDEX_HTML);
assert.ok(video, "index.html lost its 'See how Hive works' video link");
const missing = [...hrefs, adopters, video].filter((u) => !LLMS_TXT.includes(`(${u})`));
assert.deepEqual(missing, [], "on index.html but missing from llms.txt — add them as markdown links");
});
Loading