> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whilst.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> AI-powered knowledge management for teams

Whilst is a Slack bot and web application that automatically extracts knowledge from your conversations, enables powerful semantic search, and provides AI-powered assistance for managing your team's documentation.

## What Whilst Does

<CardGroup cols={2}>
  <Card title="Knowledge Extraction" icon="brain">
    Every Slack conversation is automatically analyzed and turned into structured documentation with topics, decisions, and action items.
  </Card>

  <Card title="Semantic Search" icon="magnifying-glass">
    Find documents by meaning, not just keywords, using pgvector embeddings and hybrid search with Reciprocal Rank Fusion.
  </Card>

  <Card title="AI Sidekick" icon="robot">
    Chat with AI about your docs, get intelligent suggestions, and automate document tasks from the web app.
  </Card>

  <Card title="Relationship Intelligence" icon="users">
    Tracks who works with whom on what topics, building a collaboration graph that makes future responses smarter.
  </Card>
</CardGroup>

## Key Capabilities

* **Automatic Knowledge Extraction** — Mention `@whilst` in Slack and the pipeline captures, analyzes, and documents the thread
* **Hybrid Search (RRF)** — Combines semantic similarity and full-text search for best-in-class accuracy
* **AI-Powered Analysis** — Extracts topics, decisions, action items, and sentiment from threads
* **Context-Aware Responses** — Bot understands your projects, collaborators, and conversation history
* **MCP Integrations** — Query GitHub, Linear, and Notion through natural language
* **MCP Server** — Enable AI coding assistants (Cursor, Claude Desktop, VS Code) to query and manage your docs
* **Real-time Collaboration** — WebSocket sync across clients via AWS AppSync Events

## Architecture at a Glance

```
Slack Events → API Gateway → Lambda (Intake)
                                 ↓
                              SQS Queue
                                 ↓
                          Lambda (Job Worker)
                           ├─ MCP Adapters (GitHub, Linear, Notion)
                           ├─ Knowledge Pipeline (Analysis + Auto-Doc)
                           └─ Slack Publisher (Progressive Updates)
                                 ↓
                        Neon Postgres (pgvector)
                                 ↓
                     Next.js 14 Web App (Vercel)
```

## Tech Stack

| Layer          | Technology                                                  |
| -------------- | ----------------------------------------------------------- |
| Frontend       | Next.js 14 (App Router), React, Tailwind, shadcn/ui, TipTap |
| Backend        | Node.js, TypeScript, AWS Lambda                             |
| Database       | PostgreSQL (Neon) with pgvector                             |
| AI             | OpenAI GPT-4o, text-embedding-3-small                       |
| Auth           | WorkOS (SSO, email verification)                            |
| Real-time      | AWS AppSync Events (WebSocket)                              |
| Infrastructure | AWS CDK, Vercel, GitHub Actions                             |

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get Whilst running locally in 5 minutes.
  </Card>

  <Card title="Architecture" icon="sitemap" href="/architecture">
    Deep dive into the system design.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Explore the REST API endpoints.
  </Card>

  <Card title="MCP Server" icon="plug" href="/mcp/overview">
    Connect your AI coding assistant.
  </Card>
</CardGroup>