Installation

Install via npm (Recommended)

# Install Bun (if not installed)
curl -fsSL https://bun.sh/install | bash

# Install heretic-cli globally
bun install -g @giglabo/heretic-cli

Update

bun update -g @giglabo/heretic-cli

Build from Source

For local development or contributing:

git clone <repo>
cd heretic/cli
bun install
bun run dev              # Run directly from source
bun link                 # Make available globally as heretic-cli

Native Binaries

For environments where a standalone binary is preferred:

cd cli
bun install
bun run build            # Build for current platform
bun run build:all        # Cross-platform builds

The binary is placed in cli/dist/. Move it to a directory in your PATH.

Platform Support

Prerequisites

• Docker — Required for running agent containers
• Git — For repository operations
• Bun — JavaScript/TypeScript runtime (for npm installation)

Next Steps

Once installed, head to the Quick Start guide to create your first agent.