A small open-source CLI that asks multiple AI coding CLIs (codex, claude, gemini) the same question in parallel and synthesizes their answers into one final response.
This repo holds two things:
cli/— thecouncilCLI itself, published to npmweb/— the landing page hosted at council.armstr.ng
- Node
>=22for local development - For the CLI itself: at least one supported upstream CLI installed and authenticated
Supported CLIs today:
codex,claude,gemini
If none of those CLIs are installed or authenticated, council cannot produce a real answer.
npx @armstrng/council "How should I structure this CLI?"See cli/README.md for full usage, flags, and output modes.
The landing page has its own notes in web/README.md, including how its vendored browser assets are tracked.
The two subprojects are independent — each has its own package.json and is installed separately.
# CLI
cd cli && npm install && npm run build && npm test
# Site
cd web && npm install && npm run devIf you are working on the CLI from a git checkout, run npm run build in cli/ before invoking ./bin/council.js directly so the launcher has a local dist/ build to execute.
See CONTRIBUTING.md.
See SECURITY.md.
The published npm package lives in cli/. Releases are managed by release-please, which opens a release PR from commits on main, updates cli/CHANGELOG.md, bumps the package version, tags the release, and publishes @armstrng/council from GitHub Actions.
One-time maintainer setup is still required on npm: configure a trusted publisher for the seeARMS/council repository and the .github/workflows/release-please.yml workflow, then restrict token-based publishing once that flow is verified.