Skip to content

v0.2.0 — one CLI is enough

Choose a tag to compare

@goshtasb goshtasb released this 15 Oct 19:28
· 71 commits to main since this release
436201b

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-council on 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/OpenCouncil installs the same council skill for other agents.
  • Solo mode. council init detects 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). --solo and --full force a plan; --force rewrites
    an existing config.yml and keeps customized personas, contracts and standards.
  • Quick profile. council init --quick or council 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 at tiebreak_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 doctor prints the one command that fixes each failing seat (install, login or model list) and
    suggests council init --solo --force when 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 --version reads package.json.

Fixed

  • This repository's own .council/ config is no longer tracked in git.
  • The stale open-councilmen-0.1.0.tgz is 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.tgz

Claude 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.