agentic-web

Current release line: v1.0.0 — distributed as the package-facing wrapper for the canonical runtime binary plus optional JavaScript bootstrap helpers.

🧭 Why this package exists

This npm package is the distribution wrapper around the canonical Agentic Web runtime. It exists to:

• install the right binary for your platform
• expose npx agentic-web
• provide package-facing JavaScript helpers for project bootstrap

Why does this matter?

Without a consistent package-facing wrapper, the install story drifts away from the runtime story. This package keeps binary distribution and optional project bootstrap aligned with the canonical Agentic Web release line.

⚡ Key Features

• Platform-aware binary install — downloads the correct Agentic Web binary for your environment
• Canonical CLI entrypoint — exposes npx agentic-web as a thin wrapper around the shipped Rust binary
• Package-facing JS helpers — exposes agentic-web/skills for scripted project bootstrap flows

💻 Install

npm install agentic-web

This will:

1. Download the Agentic Web binary for your platform
2. Make npx agentic-web available

🚀 CLI Usage

The package wrapper delegates to the canonical runtime binary. Discover the live CLI surface from the installed binary itself:

npx agentic-web --help
npx agentic-web run-list
npx agentic-web session capabilities

🧠 Project Bootstrap Helpers

If you want to install or refresh AGENTS policies and skill assets inside a project, use the package helper API explicitly:

import { initSkills, updateSkills, skillsStatus } from "agentic-web/skills";

await initSkills(process.cwd());
await updateSkills(process.cwd());
await skillsStatus(process.cwd());

These helpers create and maintain:

• AGENTS.md — Agent policy dispatcher
• AGENTS.vscode.MD — VS Code runtime adapter
• AGENTS.copilot-cli.MD — Copilot CLI runtime adapter
• .github/copilot-instructions.md — GitHub Copilot custom instructions
• .github/skills/*/SKILL.md — installed skill files

⚙️ Programmatic API

import { initSkills, updateSkills, skillsStatus } from "agentic-web/skills";

await initSkills("/path/to/project");
await updateSkills("/path/to/project");
await skillsStatus("/path/to/project");

🌍 Supported Platforms

| Platform | Architecture | Binary | |----------|-------------|--------| | macOS | arm64 (M1+) | ✅ | | macOS | x64 | ✅ | | Linux | x64 (glibc) | ✅ | | Linux | arm64 | ✅ | | Windows | x64 | ✅ |

👨‍💻 Developer & Creator

License

This package is licensed under the Business Source License 1.1 (BUSL-1.1).

You may use it for non-commercial and non-production purposes free of charge. Commercial or production use requires prior written authorization from the Licensor.

See ../../LICENSE for the full license text and change date.