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
allternit binary:
Usage
After installation, theallternit command is available:
Local executor API
TheLocalExecutor 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
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.
Related pages
- Gizzi Code CLI — the primary interactive CLI for the Allternit runtime
- Headless Execution — running Gizzi Code in CI and scripts
- BYOC Deployment — deploying agents to your own infrastructure
- Allternit Runtime — the execution engine used by the CLI