@compozy/agh 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NauckGroup LTDA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,108 @@
+<div align="center">
+  <img src="packages/site/public/icon-512.png" alt="AGH" width="96" height="96">
+  <h1>AGH</h1>
+  <p><strong>An open workplace for AI agents.</strong></p>
+  <p>
+    <a href="https://github.com/compozy/agh/actions/workflows/ci.yml">
+      <img src="https://github.com/compozy/agh/actions/workflows/ci.yml/badge.svg" alt="CI">
+    </a>
+    <a href="https://github.com/compozy/agh/releases">
+      <img src="https://img.shields.io/github/v/release/compozy/agh?include_prereleases" alt="Release">
+    </a>
+    <a href="https://goreportcard.com/report/github.com/compozy/agh">
+      <img src="https://goreportcard.com/badge/github.com/compozy/agh" alt="Go Report Card">
+    </a>
+    <a href="LICENSE">
+      <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
+    </a>
+  </p>
+</div>
+
+AGH is a local-first agent operating system. It runs the agent CLIs you already use — Claude Code, OpenClaw, Hermes, and others — as durable, inspectable sessions managed by a single background daemon, and connects them on the open `agh-network/v0` so sessions can discover peers, share capabilities, and close work with receipts.
+
+The complete documentation lives at [agh.network](https://agh.network).
+
+<div align="center">
+  <img src="docs/design/screen.png" alt="AGH" width="100%">
+</div>
+
+## Highlights
+
+- **AGH Network.** Active sessions become peers — they discover each other, exchange typed envelopes on `agh-network/v0` channels, and close work with receipts.
+- **Local-first durable runtime.** One Go binary and a background daemon keep sessions, events, and state in local SQLite — durable, resumable, and inspectable long after the terminal closes.
+- **Agent-manageable surfaces.** The same runtime state is exposed through CLI, HTTP/SSE, UDS, and a web UI, so agents operate AGH through structured controls instead of UI-only paths.
+- **Autonomy kernel.** Task runs, claim tokens, leases, and safe spawn keep multi-agent work observable and bounded.
+- **Extensible runtime.** Native Go tools, MCP, extensions, hooks, skills, and bridges plug into one daemon-owned tool registry.
+
+## Install
+
+```bash
+curl -fsSL https://agh.network/install.sh | sh
+```
+
+Homebrew:
+
+```bash
+brew install compozy/compozy/agh
+```
+
+npm:
+
+```bash
+npm install -g @compozy/agh
+```
+
+Go:
+
+```bash
+go install github.com/compozy/agh@latest
+```
+
+The full [Installation guide](https://agh.network/runtime/core/getting-started/installation) covers the verified binary installer, Linux packages, and source builds.
+
+## Quick start
+
+```bash
+agh install
+agh daemon start
+agh workspace add "$PWD" --name current
+agh session new --workspace current --agent general
+```
+
+See the [Quick Start](https://agh.network/runtime/core/getting-started/quick-start) for the full walkthrough.
+
+## Documentation
+
+- [Runtime overview](https://agh.network/runtime)
+- [Installation](https://agh.network/runtime/core/getting-started/installation)
+- [Quick Start](https://agh.network/runtime/core/getting-started/quick-start)
+- [CLI reference](https://agh.network/runtime/cli-reference)
+- [Extensions](https://agh.network/runtime/core/extensions)
+- [AGH Network protocol](https://agh.network/protocol)
+- [GitHub releases](https://github.com/compozy/agh/releases)
+
+## Development
+
+AGH is a Go and Bun monorepo. Install the toolchains declared by the repo and run the full verification gate before sending changes:
+
+```bash
+make verify
+```
+
+## Contributing
+
+Contributions are welcome. Open an issue or pull request, and run `make verify` before sending changes.
+
+## License
+
+AGH is released under the [MIT License](LICENSE).
+
+## Star history
+
+<a href="https://www.star-history.com/?repos=compozy%2Fagh&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=compozy/agh&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=compozy/agh&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=compozy/agh&type=date&legend=top-left" />
+ </picture>
+</a>

package/install.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+// This file was generated by GoReleaser. DO NOT EDIT.
+
+import { install } from "./lib.js";
+install();

package/lib.js

@@ -0,0 +1,259 @@
+// This file was generated by GoReleaser. DO NOT EDIT.
+import fs from "fs";
+import crypto from "crypto";
+import http from "http";
+import https from "https";
+import path from "path";
+import JSZip from "jszip";
+import { x as tarExtract } from "tar";
+import { ProxyAgent } from "proxy-agent";
+import { spawnSync } from "child_process";
+import { fileURLToPath } from "url";
+
+const { archives, name, version } = JSON.parse(
+	fs.readFileSync(new URL("./package.json", import.meta.url), "utf8"),
+);
+
+const agent = new ProxyAgent();
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const getArchive = () => {
+	let target = `${process.platform}-${process.arch}`;
+	const archive = archives[target];
+	if (!archive) {
+		throw new Error(`No archive available for ${target}`);
+	}
+	return archive;
+};
+
+const binDir = path.join(__dirname, "bin");
+
+async function extractTar(tarPath, binaries, dir, wrappedIn) {
+	try {
+		const filesToExtract = wrappedIn
+			? binaries.map((bin) =>
+				path.join(wrappedIn, bin).replace(/\\/g, "/"),
+			)
+			: binaries;
+
+		await tarExtract({
+			file: tarPath,
+			cwd: dir,
+			filter: (path) => filesToExtract.includes(path),
+		});
+
+		// If wrapped, move files from wrapped directory to bin directory
+		if (wrappedIn) {
+			const wrappedDir = path.join(dir, wrappedIn);
+			for (const binary of binaries) {
+				const srcPath = path.join(wrappedDir, binary);
+				const destPath = path.join(dir, binary);
+				if (fs.existsSync(srcPath)) {
+					fs.renameSync(srcPath, destPath);
+				}
+			}
+			// Clean up empty wrapped directory
+			try {
+				fs.rmSync(wrappedDir, { recursive: true, force: true });
+			} catch (err) {
+				// Ignore cleanup errors
+			}
+		}
+
+		console.log(`Successfully extracted ${binaries} to "${dir}"`);
+	} catch (err) {
+		throw new Error(`Extraction failed: ${err.message}`);
+	}
+}
+
+async function extractZip(zipPath, binaries, dir, wrappedIn) {
+	try {
+		const zipData = fs.readFileSync(zipPath);
+		const zip = await JSZip.loadAsync(zipData);
+
+		for (const binary of binaries) {
+			const binaryPath = wrappedIn
+				? path.join(wrappedIn, binary).replace(/\\/g, "/")
+				: binary;
+
+			if (!zip.files[binaryPath]) {
+				throw new Error(
+					`Error: ${binaryPath} does not exist in ${zipPath}`,
+				);
+			}
+
+			const content = await zip.files[binaryPath].async("nodebuffer");
+			if (!fs.existsSync(dir)) {
+				fs.mkdirSync(dir, { recursive: true });
+			}
+			const file = path.join(dir, binary);
+			fs.writeFileSync(file, content);
+			fs.chmodSync(file, "755");
+			console.log(`Successfully extracted "${binary}" to "${dir}"`);
+		}
+	} catch (err) {
+		throw new Error(`Extraction failed: ${err.message}`);
+	}
+}
+
+const run = async (bin) => {
+	await install();
+	if (process.platform === "win32") {
+		bin += ".exe";
+	}
+	const [, , ...args] = process.argv;
+	let result = spawnSync(path.join(binDir, bin), args, {
+		cwd: process.cwd(),
+		stdio: "inherit",
+	});
+	if (result.error) {
+		console.error(result.error);
+	}
+	return result.status;
+};
+
+const install = async () => {
+	try {
+		let archive = getArchive();
+		if (await exists(archive)) {
+			return;
+		}
+		let tmp = fs.mkdtempSync("archive-");
+		let archivePath = path.join(tmp, archive.name);
+		await download(archive.url, archivePath);
+		verify(archivePath, archive.checksum);
+
+		if (!fs.existsSync(binDir)) {
+			fs.mkdirSync(binDir);
+		}
+		switch (archive.format) {
+			case "binary":
+				const bin = path.join(binDir, archive.bins[0]);
+				fs.copyFileSync(archivePath, bin);
+				fs.chmodSync(bin, 0o755);
+				break;
+			case "zip":
+				await extractZip(
+					archivePath,
+					archive.bins,
+					binDir,
+					archive.wrappedIn,
+				);
+				break;
+			case "tar":
+			case "tar.gz":
+			case "tgz":
+				await extractTar(
+					archivePath,
+					archive.bins,
+					binDir,
+					archive.wrappedIn,
+				);
+				break;
+			case "tar.zst":
+			case "tzst":
+			case "tar.xz":
+			case "txz":
+			default:
+				throw new Error(`unsupported format: ${archive.format}`);
+		}
+		console.log(`Installed ${name} ${version} to ${binDir}`);
+	} catch (err) {
+		throw new Error(`Installation failed: ${err.message}`);
+	}
+};
+
+const verify = (filename, checksum) => {
+	if (checksum.algorithm == "" || checksum.digest == "") {
+		console.warn("Warning: No checksum provided for verification");
+		return;
+	}
+	let digest = crypto
+		.createHash(checksum.algorithm)
+		.update(fs.readFileSync(filename))
+		.digest("hex");
+	if (digest != checksum.digest) {
+		throw new Error(
+			`${filename}: ${checksum.algorithm} does not match, expected ${checksum.digest}, got ${digest}`,
+		);
+	}
+};
+
+const download = async (url, filename, maxRedirects = 10) => {
+	try {
+		console.log(`Downloading ${url} to ${filename}...`);
+		const dir = path.dirname(filename);
+		if (!fs.existsSync(dir)) {
+			fs.mkdirSync(dir, { recursive: true });
+		}
+
+		return new Promise((resolve, reject) => {
+			const parsedUrl = new URL(url);
+			const mod = parsedUrl.protocol === "https:" ? https : http;
+
+			const request = mod.get(url, { agent }, (response) => {
+				if (
+					response.statusCode >= 300 &&
+					response.statusCode < 400 &&
+					response.headers.location
+				) {
+					if (maxRedirects <= 0) {
+						reject(new Error("Too many redirects"));
+						return;
+					}
+					download(response.headers.location, filename, maxRedirects - 1)
+						.then(resolve)
+						.catch(reject);
+					return;
+				}
+
+				if (response.statusCode !== 200) {
+					reject(
+						new Error(
+							`HTTP ${response.statusCode}: ${response.statusMessage}`,
+						),
+					);
+					return;
+				}
+
+				const writer = fs.createWriteStream(filename);
+				response.pipe(writer);
+
+				writer.on("finish", () => {
+					console.log(`Download complete: ${filename}`);
+					resolve(dir);
+				});
+
+				writer.on("error", (err) => {
+					console.error(`Error writing file: ${err.message}`);
+					reject(err);
+				});
+			});
+
+			request.on("error", (err) => {
+				reject(new Error(`Request failed: ${err.message}`));
+			});
+
+			request.setTimeout(300000, () => {
+				request.destroy();
+				reject(new Error("Request timed out"));
+			});
+		});
+	} catch (err) {
+		throw new Error(`Download failed: ${err.message}`);
+	}
+};
+
+function exists(archive) {
+	if (!fs.existsSync(binDir)) {
+		return false;
+	}
+	return archive.bins.every((bin) => fs.existsSync(path.join(binDir, bin)));
+}
+
+export {
+	install,
+	run,
+	getArchive,
+	download,
+};

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@compozy/agh",
+  "type": "module",
+  "version": "0.0.2",
+  "description": "AGH — Artificial General Hivemind",
+  "scripts": {
+    "postinstall": "node install.js",
+    "run": "node run-agh.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/compozy/agh.git"
+  },
+  "author": "AGH Team",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/compozy/agh/issues"
+  },
+  "homepage": "https://agh.network",
+  "bin": {
+    "agh": "run-agh.js"
+  },
+  "dependencies": {
+    "jszip": "3.10.1",
+    "proxy-agent": "8.0.1",
+    "tar": "7.5.15"
+  },
+  "archives": {
+    "darwin-arm64": {
+      "name": "agh_darwin_arm64.tar.gz",
+      "url": "https://github.com/compozy/agh/releases/download/v0.0.2/agh_darwin_arm64.tar.gz",
+      "bins": [
+        "agh"
+      ],
+      "format": "tar.gz",
+      "checksum": {
+        "algorithm": "sha256",
+        "digest": "59ab94fb921808c76306cab91774c807dfdb4a9f5671ccbd7cc2c8a7205eece7"
+      }
+    },
+    "darwin-x64": {
+      "name": "agh_darwin_x86_64.tar.gz",
+      "url": "https://github.com/compozy/agh/releases/download/v0.0.2/agh_darwin_x86_64.tar.gz",
+      "bins": [
+        "agh"
+      ],
+      "format": "tar.gz",
+      "checksum": {
+        "algorithm": "sha256",
+        "digest": "f2dfe64754234bc95e008ace5c39e9f0f6fa517e4b63d11bcc9bfb7e4fd55397"
+      }
+    },
+    "linux-arm64": {
+      "name": "agh_linux_arm64.tar.gz",
+      "url": "https://github.com/compozy/agh/releases/download/v0.0.2/agh_linux_arm64.tar.gz",
+      "bins": [
+        "agh"
+      ],
+      "format": "tar.gz",
+      "checksum": {
+        "algorithm": "sha256",
+        "digest": "5ed4f624eafaa9834288dab6218e3a8f1ff9ec6e0f70d1702476d6598189a45b"
+      }
+    },
+    "linux-x64": {
+      "name": "agh_linux_x86_64.tar.gz",
+      "url": "https://github.com/compozy/agh/releases/download/v0.0.2/agh_linux_x86_64.tar.gz",
+      "bins": [
+        "agh"
+      ],
+      "format": "tar.gz",
+      "checksum": {
+        "algorithm": "sha256",
+        "digest": "6745cd37374be157c35216120e84d22932a7507ccdab4fa12ec84763c1f7ef0d"
+      }
+    }
+  }
+}

package/run-agh.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+// This file was generated by GoReleaser. DO NOT EDIT.
+
+import { run } from "./lib.js";
+run("agh").then((code) => process.exit(code));