trialog
v0.1.0
Published
A bounded three-model council CLI for aligned answers.
Maintainers
Readme
Trialog
Three models. One aligned answer.
Trialog is a local-first CLI that runs a bounded three-model council:
- one primary model drafts the answer
- two reviewer models critique it
- the primary accepts or rejects each remark
- the loop stops on approval, stagnation, or the round cap
- all three models then perform one final alignment pass
Why this exists
Most multi-agent frameworks optimize for open-ended delegation. Trialog is narrower and more opinionated:
- a fixed three-role council
- bounded review loops
- strict structured output
- local model CLI support
- transcript and report artifacts
Current scope
Trialog currently ships with CLI adapters for:
codexclaudegemini
The architecture is adapter-based so API transports can be added later without rewriting the council engine.
Install
npm installBuild
npm run buildTest
npm testUsage
Check which providers are available:
node dist/cli.js --list-providersRun with explicit roles:
node dist/cli.js \
--primary codex \
--secondary claude \
--tertiary gemini \
--task "Design a bounded review workflow for three local coding agents."Run with a chosen primary and random reviewers:
node dist/cli.js \
--primary claude \
--random-reviewers \
--task-file ./task.mdWrite transcripts and a Markdown report:
node dist/cli.js \
--primary codex \
--secondary claude \
--tertiary gemini \
--output-dir ./runs/demo \
--task "Review this design and converge quickly."Design constraints
- maximum rounds default to
5 - reviewer output is capped and structured
- reviewers are critique-only
- only the primary may get workspace tool access
- the tool fails fast if a selected provider is missing
Publishing
The trialog npm package name was available when checked against the npm registry on March 10, 2026.
