User Guide

Learn how to use ModelCouncil to make better decisions with AI

Getting Started

ModelCouncil is a multi-model AI decision tool that helps executives and founders make better decisions by querying Claude, GPT, Gemini, and Grok simultaneously against your project documents.

Quick Start

  1. 1Create a project — Give it a name that describes your decision context
  2. 2Upload documents — Add PDFs, Word docs, or text files with relevant information
  3. 3Ask a question — Query the AI models about your documents
  4. 4Review the Decision Board — See the synthesized recommendation, risks, and insights

Projects & Documents

Projects are decision contexts — containers for documents and queries related to a specific decision or topic. Each project has its own set of documents that provide context to the AI models.

Supported File Types

PDF Documents

Reports, contracts, research papers

Word Documents

.docx files with formatted content

Text & Markdown

.txt and .md files

Excel Spreadsheets

.xlsx and .xls files

Limits

  • 10 MB maximum per file
  • 20 files maximum per project
  • 100,000 tokens maximum context per project

Making Queries

When to use the Query tab: Quick questions, one-off analysis, exploring ideas without tracking history.

The Query tab lets you ask questions against your uploaded documents. Multiple AI models analyze your question and documents, then their responses are synthesized into a Decision Board.

Model Selection

Choose 2-3 models for each query. Different models have different strengths:

Claude (Anthropic)

Strong reasoning, careful analysis

GPT (OpenAI)

Versatile, great at synthesis

Gemini (Google)

Good with data, structured output

Grok (xAI)

Direct, contrarian perspectives

Decision Helper

When you ask a decision-type question (e.g., "Should we...", "Which option..."), the Decision Helper appears to help you provide structured context:

  • Options being considered
  • Constraints (budget, timeline, resources)
  • Success criteria
  • Decision timeframe

Follow-up Queries

After receiving a Decision Board, you can ask follow-up questions to dig deeper. Follow-ups include context from the previous query and recommendation.

Tip: Queries made in the Query tab aren't automatically connected to threads, but you can organize them later. See the Decision Threads section for details.

Understanding the Decision Board

The Decision Board synthesizes all model responses into a structured output that helps you make informed decisions.

Recommendation

The suggested direction with key supporting reasons

Risks

What could go wrong — the top 3 risks to consider

Validate Before Committing

Things to verify before making a final decision

Consensus

Where all models agree — high-confidence points

Disagreements

Where models differ — areas needing more thought

Rare Finds (Gems)

Unique insights from individual models worth saving

Model Response Tabs

Click on model tabs to see the full reasoning from each AI. This helps you understand where different perspectives come from.

Exporting Results

Export your Decision Board to PDF, Excel, Word, or PowerPoint for sharing with stakeholders or archiving.

Decision Threads

When to use the Threads tab: Multi-step decisions, tracking decisions over time, organized workflows where context matters.

Decision Threads group related queries into organized workflows. Unlike the Query tab, threads use intelligent context that stays manageable no matter how many queries you make.

Query Tab vs Threads Tab

Query TabThreads Tab
Quick, standalone questionsOrganized decision workflows
Full document context every timeIntelligent context (summary + relevant)
Good for explorationGood for tracking multi-step decisions
Context grows with each follow-upContext stays stable (compressed history)

How Intelligent Context Works

In a thread, the system automatically manages context to keep it efficient:

  • Document Summary — An always-on overview of your project documents
  • Relevant Chunks — Semantic search finds document sections relevant to your current question
  • Thread History — Compressed summaries of previous decisions in this thread
  • Cross-Thread Context — Related decisions from other threads in the same project

"Query 50 = Query 1"

Context size stays stable regardless of how many queries you make in a thread. This means consistent performance and costs.

Organizing Queries into Threads

Queries made outside the Threads tab (in the Query tab) aren't automatically connected to threads. You can organize these standalone queries into threads at any time.

  1. 1Click Organize in the query history sidebar
  2. 2Select the queries you want to group (checkboxes appear on unorganized queries)
  3. 3Click Add to Thread and choose an existing thread or create a new one

Note: When you organize queries into a thread, the system automatically generates compressed summaries and embeddings for each query. This enables intelligent context and cross-thread search for future queries.

Branching

From any decision in a thread, you can branch to explore an alternative direction. The new thread knows where it branched from, preserving your decision tree.

Diamond Mode

Premium feature: Models review each other's responses before the final synthesis, resulting in deeper analysis.

How It Works

  1. Round 1Initial Responses — Each model answers your question independently
  2. Round 2Cross-Review — Each model reviews the other models' responses, identifying points to adopt, reject, or add
  3. FinalDiamond Synthesis — A final synthesis that includes what changed, confidence levels, and unresolved disagreements

When to Use Diamond Mode

  • High-stakes decisions where you want maximum confidence
  • Complex questions where models might miss each other's insights
  • When you want to see how models critique each other

Cost: Diamond mode costs approximately 3x a standard query (7 API calls instead of 4).

Billing & Credits

ModelCouncil uses a credit-based system so you only pay for what you use. Credits cover the cost of AI API calls with a small markup.

Purchasing Credits

$25

~50-100 queries

$50

~100-200 queries

$100

~200-400 queries

5% bonus

Platform Subscription

$149/month platform fee provides access to all features. Credits for API usage are purchased separately.

Viewing Usage

Visit Usage & Billing in the sidebar to see your credit balance, usage history, and purchase more credits.