Repository navigation
v0.2.0 — one CLI is enough
The entry ticket drops from three CLIs to one, and the project ships through npm, the Claude Code plugin marketplace and the skills ecosystem.
Added
- Published as
open-councilon npm:npx open-council init. Install-time scripts removed from the package. - Claude Code plugin:
/plugin marketplace add goshtasb/OpenCouncil,/plugin install open-council@open-council, then/open-council:council "<task>"drives backlog → open → deliberate, stops for the human approval, then handoff → run. - Agent skill:
npx skills add goshtasb/OpenCouncilinstalls the samecouncilskill for other agents. - Solo mode.
council initdetects which provider CLIs are installed and assigns seats from what it finds.
With only Claude Code present every seat runs on Claude Code (Lead PM on sonnet, Chief Engineer on opus,
Chief Architect on sonnet with all tools disabled).--soloand--fullforce a plan;--forcerewrites
an existingconfig.ymland keeps customized personas, contracts and standards. - Quick profile.
council init --quickorcouncil open --quick: at most 4 rounds, tie-break from round 3,
one sign-off revision, the six starred review points, and documents capped at 1,200 words. - Partial result on a stall. A council that stalls, or dies on a seat failure, writes
stalled-draft-and-objections.md(task, last draft, open objections, unresolved rulings and concerns) into the
session instead of leaving nothing. It is never approvable. - Resubmission rule for the Architect review. On a resubmitted document the Chief Architect sees its previous
review and the council's response, and a concern that could have been raised on the previous version and was not
is waived. Found on the first live solo run: the Engineer ratified every revision while the Architect raised a
different advisory concern each round until the budget ran out. - Early arbitration. When open objections have not dropped for
no_progress_rounds(default 3) consecutive
rounds the Chief Architect arbitrates immediately instead of attiebreak_round. - One retry on transient seat failures. An empty reply, a dropped connection or a transient 5xx from a seat
is retried once after 5 s; timeouts are not retried. - The execution prompt names the files the dependency install step created and tells the Chief Engineer to leave
them uncommitted (observed: an unrequested "commit npm lockfile" commit on the first solo-mode PR). council doctorprints the one command that fixes each failing seat (install, login or model list) and
suggestscouncil init --solo --forcewhen only Claude Code works.ROADMAP.md, this changelog, and GitHub Discussions for ideas, questions and council run reports.- Issue and pull request templates, and a security policy.
docs/office.gif: the pixel office replaying the seat states of the session that built PR #1;docs/showcase/case studies.
Changed
- Project renamed from Open Councilmen to Open Council.
- README rewritten outcome-first: one-liner, one-line install, five-minute run, how it differs from an LLM council, showcases, honest limits.
- The Charm announcement moved out of the README into
ROADMAP.md. - CLI
--versionreadspackage.json.
Fixed
- This repository's own
.council/config is no longer tracked in git. - The stale
open-councilmen-0.1.0.tgzis no longer tracked; packed tarballs are ignored everywhere. - The repository description and homepage on GitHub pointed at the pre-rename name.
- CI runs one macOS job instead of three, after repeated 15-minute runner-acquisition failures.
Install
npm install -g open-council-cli # commands: council, open-council
npm install -g https://github.com/goshtasb/OpenCouncil/releases/download/v0.2.0/open-council-cli-0.2.0.tgzClaude Code plugin: /plugin marketplace add goshtasb/OpenCouncil then /plugin install open-council@open-council. Skill: npx skills add goshtasb/OpenCouncil.
Showcase of the first solo-mode run: council-playground PR #1, written up in docs/showcase/council-playground.md.