Council is an agent skill that forces a coding agent to deliberate with other installed agent CLIs before finalizing a plan.

Stars

22

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-14

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It introduces a novel multi-agent deliberation process that leverages existing agent CLI installations without requiring additional APIs or daemons, and logs all interactions for auditability.

Who it is for

  • Developers using Claude Code, Codex, Cursor, Gemini, Grok, or OpenCode
  • Teams that want diverse AI opinions before making code changes
  • Advanced users of agent skills looking for multi-agent workflows
  • Engineers evaluating architectural decisions or migrations

Use cases

  • Deciding whether to migrate from one framework to another
  • Getting multiple agent perspectives on a refactoring plan
  • Reviewing complex implementation strategies with safety checks
  • Auditing how different agent CLIs would approach the same task

Strengths

  • Read-only member invocations ensure safe exploration
  • Graceful handling of missing or failed agents
  • No extra API keys or daemons needed; only existing CLIs
  • Deliberation logs stored in ~/.council/ for transparency

Considerations

  • Requires at least two different agent CLIs installed and logged in
  • Deliberation process may be slower than a single-agent response
  • Limited to agent CLIs that support the Agent Skills format or manual instruction injection

README quick start

🏛 council

An agent skill that stops your coding agent from winging it: before giving you a final plan, whichever agent you're talking to must convene the other agent CLIs installed on your machine and deliberate.

Say:

council, 2 turns: should we migrate this app from Express to Hono?

and the lead agent (Claude Code, Codex, Cursor, Gemini, Grok, or OpenCode — whoever you asked) will:

  1. Draft a plan.
  2. Present it independently to every other agent CLI on your machine — each member gives exactly one reply per turn (verdict: SHIP IT / SHIP WITH CHANGES / RETHINK, strongest objections first). Members never see each other's replies.
  3. Revise the plan, telling members what changed — and repeat for as many turns as you asked.
  4. Answer with the whole deliberation as a conversation, plus the final plan.

Everything is one-shot CLI invocations under the hood (no ACP, no daemons, no API keys beyond the CLIs you already have installed and logged in). All member invocations are read-only: they may read your repo, never touch it. Failed or missing members are skipped gracefully and noted in the transcript.

Install

The skill is a single SKILL.md. Clone it where your agent looks for skills:

# Claude Code (personal)
git clone https://github.com/kitze/council ~/.claude/skills/council

# Claude Code (per-project)
git clone https://github.com/kitze/council .claude/skills/council

For other agents that support the Agent Skills format, clone into their skills directory (e.g. ~/.codex/skills/council), or just hand your agent the SKILL.md as instructions — it's self-contained.

Requirements

At least one other agent CLI installed and logged in: claude, codex, cursor-agent, gemini, grok, or opencode. The more you have, the bigger the council.

Notes

  • Deliberation sessions (plans, per-round prompts and replies) are kept in ~/.council/ so you can audit what every member actually said.
  • SKILL.md embeds the exact headless flags each CLI needs (cursor --trust, gemini --skip-trust, codex read-only sandbox, and the grok --system-prompt-override workaround for its silent headless cancellation) — found the hard way so you don't have to.

License

MIT

Description

🏛 Agent skill: your coding agent must convene the other agent CLIs on your machine and deliberate for X turns before giving you a plan

Related repositories

Similar projects matched by category, topics, and programming language.

MoonshotAI
Featured
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI & Machine LearningAI Agents
3,348
xuchonglang
Featured
xuchonglang GitHub avatar

investing-for-beginners

A structured investing guide for Chinese beginners covering US stocks, options, and cryptocurrency, with focus on foundational concepts and risk awareness.

Blockchain & Web3
2,739
Krishnagangwal
Featured
Krishnagangwal GitHub avatar

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

Data & DatabasesDatabases & Storage
2,326