KoraCouncil

Getting started in three steps

1. Ask anything. Type your question in the chat bar and hit ↑. The default Council Debate mode is a great starting point for almost any question.
2. Pick the right mode when it matters. Every new session greets you with a mode-picker landing — columns of modes with Prompt Builder up top. You can also switch any time: on the web tap the mode pill in the chat bar (or press ⌘K / Ctrl-K); on the iPhone tap the ＋ button or open the sidebar. Want a research deep-dive? A second opinion on some work? A drafted email? There's a mode for it — see the Modes tab.
3. Make it yours. Use Projects to group related chats with shared instructions and files, connect your accounts under Settings → My Connections, and add a note to User Memory so the council remembers your context across every session.

Finding your way around

• Left sidebar — your current mode, Projects, and Sessions live here, plus a search box that finds any past chat by name or content. See Projects & Sessions.
• Collapsed icon rail (web) — collapse the sidebar and it becomes a slim icon rail; the Search, Prompt Builder, Modes, Projects and Sessions icons open a flyout right there without re-expanding.
• Mode picker (⌘K) — the fastest way to switch modes. Just start typing the name.
• Settings — the gear at the bottom of the sidebar opens your connections, projects, personalization, blueprints, and audit log.
• This guide — the Guide button up top reopens it any time.

Prompt Builder — it writes the prompt with you

Not sure how to ask? Prompt Builder interviews you and drafts a strong prompt. Open it from the accent Prompt Builder button on the new-session landing, the ✎ Prompt Builder icon on the collapsed sidebar rail, or the pinned Prompt Builder row at the top of the sidebar's mode list.

Pick a starting point — Research, Writing, Image, or "I need to explain & attach files" — then answer a few quick questions. It's never a dead end: one button reads Next while it's still interviewing you and Submit the moment it has enough (an accent ✦ Build prompt now line also appears so you can build any time).

When the prompt is ready you can Copy it, Save to my prompts, or send it straight into a mode: the builder suggests 3–4 modes that fit your prompt (an Image prompt always offers Image mode), and below the suggestions every mode is laid out as pills in the same category groups as the mode picker — tap one to start that session pre-filled with your prompt. Prompt Builder chats live in their own Prompt Builder group in the sidebar.

Voice notes — speak your prompt

Tap the 🎙 mic in the composer tool-rail, speak for as long as you like, then Stop. Your audio is transcribed and gently cleaned for reading — filler removed, punctuation and paragraphs added — without changing your words. Hit Use in Prompt Builder and the readable text drops straight into the composer so you can start building. Every note is saved to your Library (the mic panel’s Library tab): reopen any note to read it, play it back karaoke-style with the words highlighting as they’re spoken, rename or delete it, or feed it into the Prompt Builder again.

Prompt Library

Tap Browse library inside Prompt Builder to open the Prompt Library: curated expert prompts grouped by category, plus My prompts (anything you saved). Copy any prompt or Send it to a mode. You can also manage My prompts under Settings → Prompt Library.

Modes — pick the right tool for the job

Tap the mode pill in the chat bar, or press ⌘K / Ctrl-K, to open the picker. Start typing to filter. Modes are grouped — here's what each one is for.

Council

Executive

Operations

Agentic Loops

Find these by name in the mode picker (⌘K).

Create

Direct models (no council)

Modes that take real actions on your behalf always draft a blueprint you approve first, and every external action lands in your Audit Log — see the Blueprints & Audit tab.

The Parallel / Role toggle

For council modes that involve several members, the chat bar shows a small Parallel | Role toggle. It changes how the council works on this run:

• Parallel — every member works the question independently, as themselves. You get a spread of genuinely different takes.
• Role — each member puts on a different hat (Architect, Skeptic, Researcher, Pragmatist, Visionary, Verifier, User Advocate…) and argues from that lens, then it's all synthesized across roles. Great when you want pressure-tested, well-rounded coverage.

The toggle applies to: Debate, Consensus, Brainstorm, Research, Verify, Brief, Monitor, Strategize, and Assignment. It only shows up when the current mode supports it, and it remembers your choice per mode.

Tip: try the same question once in Parallel and once in Role — they often surface very different things.

How rounds work

In a debate, the council runs a couple of rounds on its own — you just watch the answers come in. When they're done, a card appears asking what you'd like next: Send to Arbiter for the final synthesis, or Add Another Round for more back-and-forth. There's no limit — keep adding rounds until you're happy.

On iPhone the decision card reads "Round complete — your call" with Add a Round and a final-stage button (Send to Arbiter / Final Synthesis / Reach Consensus, depending on the mode).

Steer the next round

Type a note in the chat bar before you click Add Another Round, and that becomes your instruction for the next round ("focus on cost", "push back harder", etc.). Leave it empty for a general refinement.

Interject any time

You don't have to wait. Drop a message into the chat bar while the council is working — on the web the send button itself turns into Interject. Your note gets queued and the council picks it up at the next step to either steer the discussion or add it as context. You can interject as many times as you like, and each one is saved to the transcript so you can scroll back.

On iPhone, while the council is running the send arrow becomes a red Stop; to steer mid-run use the ＋ menu → Interject.

Pick up where you left off

Refresh, close the tab, come back tomorrow — your decision card and round controls are exactly where you left them.

And if a run ever gets interrupted (a lost connection, a restart, a closed laptop) — in any mode, from a debate to a brainstorm to the Prompt Builder mid-interview — reopening the session shows a "Session paused — your work is SAFE" notice with a Continue button. One tap finishes the run from what was already saved: completed answers are kept, only the missing pieces run, and you never retype a thing.

When a member fumbles

If a member's response comes back broken or it doesn't finish, the council flags it and tucks it behind a one-line "Response flagged" shade (tap to peek). You decide what to do with that seat:

• Re-run — have that member try again.
• Reconsider — ask them to take another pass at it.
• Keep — keep the flagged answer anyway.
• Drop — leave that member out of this round.

Nothing finalizes while a fumble is waiting on you — you stay in control of the result.

After the debate — keep talking

Once a debate finishes, the bar at the top of the chat gives you filter buttons (All / Claude / ChatGPT / Gemini / Grok / DeepSeek / Qwen / MiniMax / GLM / Kimi) alongside the round controls. You can keep chatting about the result right there.

Filter the transcript

Tap a member's name and only their messages stay on screen — your own prompts always stay visible. Tap All to bring everyone back. These filters are just a view; they don't change who answers next.

Talk to one member

To direct your next prompt at a single model, pick that model from the mode picker (e.g. "Claude — Expert"). Your message goes only to them — a one-on-one.

@mentions

Start a prompt with @claude, @chatgpt, @gemini, @grok, @deepseek, @qwen, @minimax, @glm, or @kimi to address that member directly.

Image mode

Tap the ✦ sparkle button in the chat bar — the chat flips into Image mode (the mode pill reads "Image — Generate"). From there, just type a description and hit ↑ to generate. Keep typing new prompts in the same session to keep iterating. You can also pick Image from the mode picker (⌘K).

Refine an image

Every image you make has a Use as reference / Refine button. Tap it and that image loads back in as a reference with your prompt seeded — perfect for "same idea, but…" tweaks.

Reference images

You can also feed in your own reference images and choose the model, aspect ratio, count, and style from the image controls. Generated images stay inline in the chat across refreshes — right-click → Save As to download.

Quick one-off: type /imagine your prompt from any chat to generate without switching modes. Switch to Image mode when you want to keep iterating.

The model picker

Tap the mode pill in the chat bar (or press ⌘K) to choose what happens next. Start typing to filter — modes and models both show up. For what each mode does, see the Modes tab.

Council, parallel, or one-on-one

• Council Debate (default) — the full council works your question together.
• All Models — ask every model at once; each replies independently, no synthesis. Pick Best / Balanced / Fast on the composer toggle. Great for a quick side-by-side.
• A single model — pick one provider at one tier for a direct one-on-one.

Three tiers

Each provider comes in three tiers, so you can trade depth for speed and cost:

• Expert — the strongest model, for the hard stuff.
• Assistant — fast and capable, the everyday workhorse.
• Intern — lightweight and quick, for simple fan-outs.

The nine members

The council is Claude, ChatGPT, Gemini, Grok, DeepSeek, Qwen, MiniMax, GLM, and Kimi. Here are the models currently behind a few of them:

Claude

…

ChatGPT

…

Gemini

…

Grok

…

DeepSeek

…

Qwen, MiniMax, GLM, and Kimi round out the council too. Use the picker's filter box to jump to any specific model.

Tools & Connectors — one place

Everything the council can reach lives under Settings → Tools & Connectors: web search, reading URLs, files, and your connected accounts. At the top is a simple “who can do what” grid — one glance shows which model can search the web, read a link, use files, or reach your connectors, and how (native, OpenRouter, or a tool). Web search is on by default; an admin can tune it there.

My Connections

Connect your own accounts so the council can work with your real stuff — read your Google Drive, draft your Gmail, check your Calendar. Open Settings → Tools & Connectors → My Connections and connect each one with a single tap.

• Private to you — your connections are yours alone, encrypted, and never visible to anyone else's council.
• Google Drive — the council can read and search your files for context.
• Gmail — read for context, and draft (or, with your OK, send) messages in Communicate mode.
• Google Calendar — read your schedule for coordination and concierge tasks.
• Disconnect any time — revoking a connection cuts off access immediately.

MCP Servers & Tool Catalog

Want more? In Settings → Tools & Connectors, admins can open MCP Servers & Tool Catalog — register tool servers and browse the ready-to-add tools (one shared list). Most are one tap to add; some ask you to sign in or paste a key. Once added, the council can use them on your tasks — all under the same approve-first, audited flow.

Files & default tools

The Tools & Connectors pane also lists the file types you can attach (images, PDFs, Office docs, text, spreadsheets & more) — the same list drives the ＋ attach menu and drag-and-drop. Built-in tools (web search, URL-reading) are on demand — models call them only when a question needs them.

Works everywhere

Your connections live with your account, so they're the same on the web app and the iPhone app — connect once, use everywhere.

Anything done through a connection runs through a blueprint you approve first and lands in your Audit Log — see the Blueprints & Audit tab.

Agent Mode — a model runs commands on your server

Pick Agent — Server Tools from the mode picker to let one model run real shell commands over SSH on your own server (git status, builds, tests, deploys) through a guarded run_shell tool. Describe the task, hit Send, and the model works step by step.

Ask vs Autonomy

• Ask (default, safe) — you approve every command before it runs.
• Autonomy — commands run without asking, except anything dangerous (rm -rf, force-push, deploys, DROP/TRUNCATE, curl|sh …), which always asks — even here.

Approvals & questions — detailed choice cards

When a command needs your OK, a card shows the exact command, the model's reason for running it, and your choices — each a full card with a one-line description: Approve once, Approve & remember this session, Approve & remember always, or Deny. You can also type an instruction back to the model. If the model needs a decision, it asks the same way — labelled options, each with a short description, plus a type-your-own box.

Server Access — SSH + GitHub

Open Settings → Agent / Server Access to store your credentials, encrypted at rest and never shown again:

• SSH host, user, and private key — use a non-root, limited-privilege account so a misbehaving command is contained.
• GitHub token (optional) — a fine-grained or classic PAT. When set, the agent can use gh and authenticated git on your server — GitHub writes (open a PR, push) still ask first.

Your credentials are private to you and used only by your own Agent runs. Dangerous commands always confirm, in every mode.

Task Blueprints — approve before it acts

When you use a mode that actually does something (Assignment, Communicate, Concierge, Coordinate, and the Task loop), the council first writes up a blueprint — a plan of exactly what it intends to do. Nothing happens until you say go.

Open Settings → Task Blueprints. Each one is private to you. Open a blueprint to read or tweak its objective, summary, constraints, and deliverables, then hit Approve when it's ready. No blueprint, no action.

Audit Log — a record of everything

Open Settings → Audit Log for a timeline of every external action taken on your behalf, newest first. Each entry shows what was done, which tools and connections it used, and its approval state. Tap Refresh to pull the latest.

Approve-first plus a full audit trail means you're always in control of what the council does for you.

Sessions

Every chat is a session. They're listed in the sidebar, grouped by when you last used them (Today, Yesterday, and so on). Tap ＋ New Session to start fresh.

Search

Use the search box at the top of the sidebar to find any past chat — it matches both the session name and the content of the messages inside, so you can find that conversation even if you don't remember what you called it.

Session actions

Each session row has a ⋮ menu (and a pin):

• Pin — tap the star to keep important sessions at the top of the list.
• Rename — give it a clearer name (or use the /rename command). New chats name themselves from your first message; a manual rename always wins and sticks.
• Move to project — file it under one of your projects (or back to top-level).
• Delete — remove it (you'll be asked to confirm).

Projects (workspaces)

Projects group related sessions under a folder with their own shared instructions and files. Tap ＋ New in the sidebar's Projects section to create one, then tap a project name to expand or collapse its sessions.

Project settings

Tap the gear next to any project to open its settings:

• Name — rename it any time.
• Custom instructions — added to every prompt in this project's chats.
• Project files — upload files (up to 10MB each) that the council sees on every prompt in the project. You can select multiple files at once.
• Use global context toggle — keep your global instructions, memory, and files in the mix, or turn them off so the project runs purely on its own context. (Your User Memory always applies.)
• Delete — the project's sessions move back to top-level (they're not deleted); the project's files are removed.

Super Coding sessions

The Head Coder picker beside the composer decides which model plans and integrates the run — change it any time, per session. Alongside the usual models you can pick an agentic CLI seat: slower to start, but it can read the actual repo before planning, which makes for a much better breakdown on a real codebase.

Super Coding sessions get their own group in the sidebar, sitting just above Sessions, so a long-running build never gets buried among your everyday chats. Tap ＋ New there to start one — it opens a fresh session already set to Super Coding, ready for you to describe what to build.

Once you have a few, you can tidy them into folders: tap ＋ New folder at the bottom of the group to make one, then use the little folder button on any session row to file it away. Folders rename, collapse, and delete from their ⋮ menu — deleting a folder only removes the folder, never the sessions inside it (those move back to the ungrouped list). Folders are remembered in this browser.

A Super Coding session always lands in this group — no matter which project you started it from. If you began it inside a project it stays filed under that project too; the group is a lens on everything Super Coding, the project is where it lives. Prompt Builder works the same way.

Your folders follow you between devices. File a session on your laptop and it is filed on your phone and in every other browser too. Whether the group is open or collapsed stays local to each device on purpose — collapsing it on your phone will not collapse it on your desktop.

Web access

The council can read the live web. Two ways to trigger it:

1. Paste a URL

Drop any https://... link into your prompt. Up to 5 URLs per message. Example:

Check this page and tell me what you think:
https://example.com/article

2. Ask them to search

Use phrases like "search the web for X", "google X", "look up X", "find online X", or "web search for X". Example:

Search the web for the latest Pokémon TCG set release dates

Give the council files to read

The council can read documents and images you share. Attach from the ＋ menu, drag and drop onto the chat, or paste straight in. Supported types include:

• Images — PNG, JPG, and friends (the council can see them).
• Documents — PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), CSV, Markdown, plain text, and more.

Where files can live

• In a message — attach a file to a single prompt.
• In a project — project files ride along with every prompt in that project (see Projects & Sessions).
• Globally — Settings → Personalization lets you set global files and custom instructions that apply everywhere.

Global + session memory

Open Settings → Personalization → User Memory to jot down durable facts about you — your role, your preferences, what you're working on. Your User Memory and global instructions ride along on every prompt in every mode, across all your sessions, and the council can add durable facts over time. It's yours and private.

Canvas

The Canvas button (in the header) pulls code blocks out of the council's answers into a side panel where you can save, copy, or diff them.

Chat layout

Under Settings → Personalization → Chat Layout, choose how council answers are shown:

• Stacked (default) — a clean top-to-bottom flow of messages.
• Columns — each round's member answers sit side by side as cards (a few across on desktop, fewer on tablet, one on phone). Each card has a Show full toggle to expand it.

Make it readable

Personalization also has a font-size control, so you can scale the text up or down to taste.

The sidebar

• ＋ New Session — start a fresh chat.
• Search — find any past chat by name or content.
• Projects — your workspace folders.
• Sessions — your chats, grouped by recency, pinned ones up top.
• Your avatar + the settings gear at the bottom.
• Collapse to an icon rail — collapse the sidebar and it becomes a slim rail; each icon (Search, Prompt Builder, Modes, Projects, Sessions) opens its section in a flyout without re-expanding.

Slash commands

@ mentions

Keyboard

Export a session

Open the export option from the chat bar to download the current session. You can filter by date range and by who said it (everyone / AI only / you only), then save as:

• PDF — a clean, color-coded transcript with the noise stripped out.
• JSON — the full raw session, handy if you want the data.

Saving images

Generated images stay inline in the chat across refreshes — right-click → Save As to download any of them.

Native iOS app

There's a native iPhone app (currently via TestFlight). It uses the same iOS-style composer as the web (＋ menu, ↑ send, mode-aware placeholder) and shares your account: your settings, connections, projects, and sessions sync across web and app. Settings are fully editable in-app on iOS too — including My Connections, Personalization, and push prefs — and any change persists back to the web.

Install as a web app (PWA)

iPhone Safari: tap Share → Add to Home Screen. Opens fullscreen with no browser chrome — looks and feels like a native app.

Android Chrome: menu → Install app, or Chrome will offer an Install banner.

Desktop Chrome / Edge: address bar → install icon (or menu → Install KoraCouncil).

Push notifications

Turn these on under Settings → Personalization → Push Notifications to get a nudge when:

• A round finishes and a decision is waiting for you.
• The Arbiter wraps up the final answer.

You can opt out of individual events. iOS note: push only works once you've added the app to your Home Screen (regular Safari can't receive it), on iOS 16.4 or later.

Your account

Your avatar and the settings gear sit at the bottom of the sidebar. From Settings you can:

• Manage your connections and the Tool Catalog (Drive, Gmail, Calendar, and more).
• Review and approve your Task Blueprints, and check your Audit Log.
• Edit your User Memory and global instructions under Personalization.
• Set your chat layout, font size, and push notification preferences.
• Change your password.
• Log out (the button at the bottom of the settings menu).

Same account, everywhere

Everything here — your settings, connections, projects, and sessions — syncs between the web app and the iPhone app, and you can edit it from either one.

Tips to get more out of the council

• Start with Debate, switch when you have a reason. It's a great default. Reach for Research, Verify, Brief, or the others when the job is specific.
• New here? Let Prompt Builder draft it. Hit Prompt Builder on the landing and let it write the prompt with you.
• Save prompts you reuse. Add them to My prompts (Prompt Library), then Send them straight to a mode.
• Learn ⌘K. The mode picker is the fastest thing in the app — just press ⌘K and type.
• Try Parallel vs Role on the same question. Independent takes and role-based hats surface different things.
• Add another round when the answer's close but not quite there — and type a note first to point the council at what to fix.
• Interject instead of starting over. Drop a correction mid-run and the council folds it in.
• Feed it your files. Attach a document or image and ask about it directly.
• Use Projects for ongoing work. Shared instructions and files mean you don't repeat context every time.
• Fill in User Memory once. A few facts about you make every answer more relevant.
• Connect your accounts to let the council draft email, read a doc, or check your calendar — always with your approval first.
• Lost a chat? Search. The sidebar search finds it by name or by what was said inside.