@lwrf42/emerge-cli

Command-line interface for the emerge agent harness: run, replay, probe, and status commands.

v0.1.0 — early. See main repo for verified-vs-unverified surfaces.

Install

npm install -g @lwrf42/emerge-cli

Or run without installing:

npx @lwrf42/emerge-cli run blueprint.yaml

Commands

# Run an agent from a blueprint YAML
emerge run blueprint.yaml

# Replay a recorded session from a JSONL log
emerge replay session.jsonl

# Probe model capability on a task
emerge probe blueprint.yaml

# Show session status
emerge status

Blueprint format

# blueprint.yaml
id: my-task
title: Fix the broken function
provider:
  kind: openai-compat
  baseURL: ${EMERGE_LLM_BASE_URL}
  model: ${EMERGE_LLM_MODEL}
systemPrompt: |
  You are a senior engineer. Fix the bug in the repo.
tools:
  - fs_read
  - fs_write
  - bash

Quick example

EMERGE_LLM_BASE_URL=http://localhost:11434/v1 \
EMERGE_LLM_MODEL=llama3.2 \
emerge run blueprint.yaml

Documentation

Full docs: https://github.com/LemonCANDY42/emerge