Skip to content

Manual

How to use Cosmic Council.

Everything on this page works today. Start free with a public council; sign in when you want a council of your own — with your voices, your documents, your library.

Try a public councilWhat is Cosmic Council?

Know the shapes

Council
A seated group of AI voices convened around a purpose. Public councils are open to everyone; private councils live in your workspace.
Member
One voice on the council, with its own identity, instruction, color, optional avatar, optional AI model — and its own knowledge.
Chair
The orchestrator. It poses your question to every member, then weaves the answers into one consensus using the council's strategy.
Knowledge
Documents and notes a member is grounded in. Retrieved semantically when the member answers, with disclosure you control.
Run & thread
One question and its full deliberation. Signed-in runs are kept; any run can become a shareable thread — private, unlisted, or public.
Marketplace artifact
A council, single voice, or saved conversation published to the library — Free, Premium, or Original — that you can add to your shelf or fork.

What councils are used for

  • Decisions with real trade-offs. Seat a strategist, a skeptic, and a customer advocate; ask once and read where they disagree before you commit.
  • Thinking with your reading. Upload a book, a report, or a paper trail as member knowledge and question a voice that answers from that source — and says when the source is silent.
  • Recurring reviews. A council you shaped once — your tone, your constraints, your documents — answers the same class of question consistently every week.
  • Personal reflection. Councils like Inner Wisdom exist to slow a hard question down and hold it up to several lights.
  • Publishing a deliberation. A good answer is worth keeping: share a thread publicly, or offer a whole council on the marketplace.

How-tos

Ask a public council (free, no account)

  1. On the homepage, flip to a featured council — or open any public council page.
  2. Type your question into the composer and convene the council.
  3. Watch each member answer in its own voice, then read the chair's consensus at the end.

Sign in with a magic link

No passwords. Your email address is your key.

  1. Open Sign in and enter your email address.
  2. Open the email we send and click the sign-in link on the same device or any other.
  3. Create a workspace when prompted — councils, members, and knowledge live inside it.

Create a council of your own

Three ways in, all from your Councils home.

  1. Start blank — one click creates a private draft (a chair and no members yet) and lands you in the builder.
  2. Duplicate one of yours — clone an existing council and tweak the copy.
  3. Fork a marketplace council — any fork-permitted template becomes yours to reshape.
  4. In the builder, name the council, write its purpose, pick the consensus strategy, and seat members.

Shape a member's voice

  1. Open the council's builder and expand a member panel.
  2. Edit the name, description, and soul instruction — the standing brief that defines how this voice thinks and speaks.
  3. Pick a per-member AI model, or leave it inheriting the council default.
  4. Choose the member's color, and optionally upload an avatar (SVG, PNG, JPG, or WebP up to 2 MB) that hovers in front of its flame.
  5. Editing a shared template member quietly forks a private copy into your account first — originals are never changed.

Give a member knowledge

Members answer better when they are grounded in your actual documents.

  1. From a member panel, open Manage knowledge.
  2. Upload .txt, .md, .pdf, .docx, or .epub files (up to 25 MB each), or paste a note directly.
  3. The text is extracted, chunked, and embedded; when the member answers, the most relevant passages are retrieved semantically.
  4. Set the public disclosure level per knowledge base: nothing, summary stats, or short excerpts — you decide what outsiders may see about the sources.

Run a deliberation and share it

  1. Ask your council a question from its page — members deliberate in parallel and the chair synthesizes.
  2. Signed-in runs are kept automatically, so you can revisit any deliberation.
  3. Publish a run as a thread when it is worth keeping: private (only you), unlisted (anyone with the link), or public (listed and shareable).

Use the marketplace

  1. Browse the marketplace for councils, single voices, and saved conversations — Free, Premium, or Original.
  2. Add an artifact to your shelf, or fork a fork-permitted council into your workspace to make it your own.
  3. Forked councils deep-copy their bundled knowledge, so your copy stands alone.

Connect from an AI chat app (MCP)

Cosmic Council is itself an MCP server — compatible AI clients can convene your councils directly.

  1. Point your MCP-compatible client (Claude, and others) at https://www.cosmiccouncil.space/api/mcp.
  2. Without signing in, your client can list public councils, read them, and ask them questions.
  3. Add your account's access token to unlock creator tools: create and configure councils, seat and voice members, upload knowledge and avatars.
  4. Large documents upload directly to storage via presigned URLs — no size-bloated chat payloads.
  5. Building from a document set? Ask for a council draft first: the draft tool proposes members, voices, and knowledge mappings with zero writes; apply it only once you have reviewed it.

Frequently asked

Do I need an account to try Cosmic Council?
No. Every public council can be asked a question without signing in. An account (free, magic-link email sign-in) is needed to create councils, give members knowledge, and keep your runs.
What file types can a council member learn from?
Plain text (.txt), Markdown (.md), PDF (.pdf), Word (.docx), and EPUB (.epub) — up to 25 MB per document. The text is extracted, chunked, and retrieved semantically when the member answers.
Can other people see my council's knowledge?
You decide per knowledge base. Disclosure levels range from nothing at all, to summary statistics, to short excerpts. Private councils and their knowledge are never visible to others.
Can I use my councils from Claude or another AI chat app?
Yes. Cosmic Council ships a first-party MCP endpoint at /api/mcp. Anyone can list and ask public councils; signed-in creators can build councils, upload knowledge, and even draft a council from a set of documents — all from a compatible AI client.

Questions this page doesn't answer? Ask a council.

Convene your first council →