Allternit TypeScript CLI

The Allternit TypeScript CLI (@allternit/cli-typescript) is a lightweight command-line package that demonstrates local parallel execution through the Allternit Runtime bridge. It is distributed as the allternit bin entry and is intended for scripting, CI pipelines, and custom tooling surfaces.

Overview

The CLI wraps @allternit/runtime and executes a configured goal across multiple variants. Each variant runs in sequence within the local process, with results collected into a single run report. The package is a thin integration surface; production agent orchestration should use Gizzi Code or the Allternit API.

Installation

Or add it to a project:
The package exposes the allternit binary:

Usage

After installation, the allternit command is available:
The current implementation focuses on local executor integration. A typical invocation creates a run configuration with a goal and one or more variants, then executes them through the runtime bridge.

Local executor API

The LocalExecutor class is the core of the CLI. It initializes an AllternitRuntimeBridge and runs variants locally.

Constructor

The constructor creates an AllternitRuntimeBridge rooted at process.cwd() and stores receipts in ./.allternit/receipts.

Methods

Run configuration

Response

The top-level status is completed only when every variant completes successfully; otherwise it is failed.

Package metadata

Commands

Error handling

Tool errors are surfaced in the variant’s output field as the error message.