Skip to content

Repository files navigation

Alab CLI

Alab is one self-contained executable for AgentLab tools. The current release integrates AgentLab Pages, a static site publisher backed by your own Cloudflare account.

No separate Node.js, npm, Bun, Python, Go, Wrangler, or helper CLI installation is required to run a downloaded binary.

Install

Download the archive matching your system from the repository's Releases page, verify it with SHA256SUMS, extract alab, and put it on your PATH.

Supported release targets:

Operating system CPU
macOS Apple silicon, Intel
Linux x86-64, ARM64

Windows is not currently built or tested.

alab --version
alab pages --help
alab pages setup
alab pages put ./site

alab pages setup guides Cloudflare API token validation, account selection, and project creation or reuse. Pages maintains authoritative state on one machine. A repeated put of the same directory retains its ID and URL. Cloudflare's default URL is used unless configuration explicitly supplies another base URL.

See USAGE.md for setup, command behavior, and limitations. See docs/integration.md for the internal tool interface and update procedure.

Build

The repository pins Bun and every tool revision. Bun is a build dependency only.

bun install --frozen-lockfile
bun run verify:pins
bun run test
bun run build
bun run test:binary

bun run build:all cross-compiles the four declared release targets into dist/.

Every CI run retains its four verified platform binaries as downloadable workflow artifacts. Tagged releases package the same target set into archives with a SHA256SUMS manifest.

Security

Every published page is public. The optional Pages root password only obscures the root listing and does not protect direct page URLs. Never publish credentials or private content.

License

MIT

About

One self-contained CLI for AgentLab tools

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages