@laloomery/weave

The weave CLI: turn a session transcript into curated project documents from the shell.

weave is the standalone command of the weave monorepo. It wires @laloomery/weave-core to a host adapter, loaded at runtime by --host.

This is a command, not a library — it exposes no importable API.

Install

npm install -g @laloomery/weave

The adapter for your host must also be installed (e.g. @laloomery/weave-adapter-pi), plus the relative coding-agent SDK. Requires Node.js 20.6+.

Quickstart

weave <session.jsonl> --targets targets.yaml --host pi --model provider/id

• --host <pi> — adapter to load. Required, unless a host key is in $WEAVE_CONFIG.
• --model provider/id — scribe model. Required, unless a model key is in $WEAVE_CONFIG.
• --sdk-path <path> — SDK override (fork/local link).
• --dry-run — print fragments, write nothing.
• --help — full usage.

Defaults for these flags can live in a JSON file pointed to by the $WEAVE_CONFIG env var; flags always win.

Configuration

The CLI reads settings from $WEAVE_CONFIG only, and describes targets.yaml, the write modes, and the dedup behavior in one place — the monorepo README. To avoid drift, this page does not duplicate them:

• targets.yaml reference
• CLI settings ($WEAVE_CONFIG)
• Write modes, prompt regimes, dedup

License

See the monorepo.