mkdocs.yml

site_name: Bernstein
site_url: https://bernstein.readthedocs.io/
site_author: Alex Chernysh
site_description: >-
  Bernstein is the open-source multi-agent orchestration platform for AI coding
  agents. Run Claude Code, Codex, Gemini CLI in parallel with deterministic
  scheduling, 18+ adapters, and zero vendor lock-in.
repo_url: https://github.com/chernistry/bernstein
repo_name: chernistry/bernstein
edit_uri: edit/main/docs/
copyright: >-
  Copyright &copy; 2025–2026 <a href="https://alexchernysh.com">Alex Chernysh</a>

theme:
  name: material
  custom_dir: docs/overrides
  palette:
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: deep purple
      accent: amber
      toggle:
        icon: material/brightness-7
        name: Switch to light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: deep purple
      accent: amber
      toggle:
        icon: material/brightness-4
        name: Switch to dark mode
  font:
    text: Inter
    code: JetBrains Mono
  features:
    - navigation.instant
    - navigation.instant.progress
    - navigation.tracking
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.expand
    - navigation.top
    - navigation.indexes
    - navigation.footer
    - search.suggest
    - search.highlight
    - search.share
    - content.code.copy
    - content.code.annotate
    - content.action.edit
    - content.tabs.link
    - toc.follow
    - announce.dismiss
  icon:
    repo: fontawesome/brands/github
    logo: material/music-note-eighth

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/chernistry/bernstein
      name: Bernstein on GitHub
    - icon: fontawesome/brands/python
      link: https://pypi.org/project/bernstein/
      name: Bernstein on PyPI
    - icon: fontawesome/solid/globe
      link: https://alexchernysh.com
      name: Alex Chernysh
  analytics:
    provider: google
    property: G-PLACEHOLDER
    feedback:
      title: Was this page helpful?
      ratings:
        - icon: material/thumb-up-outline
          name: This page was helpful
          data: 1
          note: Thanks for your feedback!
        - icon: material/thumb-down-outline
          name: This page could be improved
          data: 0
          note: Thanks, we'll improve this page.
  generator: false
  consent:
    title: Cookie consent
    description: >-
      We use cookies to recognize your repeated visits and preferences,
      as well as to measure the effectiveness of our documentation and
      whether users find what they're searching for. With your consent,
      you're helping us to make our documentation better.

plugins:
  - search:
      separator: '[\s\-\.]+'
  - social:
      cards_layout_options:
        background_color: "#4a148c"
        color: "#ffffff"
  - tags
  - minify:
      minify_html: true

markdown_extensions:
  - admonition
  - pymdownx.details
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.tabbed:
      alternate_style: true
      slugify: !!python/object/apply:pymdownx.slugs.slugify
        kwds:
          case: lower
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.keys
  - pymdownx.mark
  - pymdownx.critic
  - toc:
      permalink: true
      toc_depth: 3
  - attr_list
  - md_in_html
  - def_list
  - tables
  - footnotes
  - abbr

nav:
  - Home: index.md
  - Getting Started:
      - Quickstart: GETTING_STARTED.md
      - Tutorial: quickstart-tutorial.md
      - Install on Linux: install-linux.md
      - Configuration: CONFIG.md
  - Concepts:
      - Architecture: ARCHITECTURE.md
      - Design: DESIGN.md
      - Task Lifecycle: LIFECYCLE.md
      - The Bernstein Way: the-bernstein-way.md
      - Glossary: GLOSSARY.md
  - Guides:
      - Adapter Guide: ADAPTER_GUIDE.md
      - Plan Files: plans.md
      - Hook System: hook-system.md
      - Plugin SDK: plugin-sdk.md
      - Cost Optimization: cost-optimization.md
      - Performance Tuning: performance-tuning.md
      - Security Hardening: security-hardening.md
      - GitHub Action: github-action.md
      - GitHub App Setup: github-app-setup.md
  - Deployment:
      - Deployment Guide: deployment-guide.md
      - Cluster Mode: CLUSTER.md
      - Helm Deployment: HELM_DEPLOYMENT.md
  - Reference:
      - API Reference: openapi-reference.md
      - Feature Matrix: FEATURE_MATRIX.md
      - Model Policy: MODEL_POLICY.md
      - Compatibility: compatibility.md
      - Dependency Resolver: DEPENDENCY_RESOLVER.md
      - Known Limitations: KNOWN_LIMITATIONS.md
      - Troubleshooting: TROUBLESHOOTING.md
      - Changelog: CHANGELOG.md
  - Migration:
      - Migration Guides: migration-guides.md
      - From CrewAI: migration-from-crewai.md
      - From LangGraph: migration-from-langgraph.md
      - Zero Lock-in: zero-lock-in.md
  - Blog:
      - Zero-LLM Coordination: blog/zero-llm-coordination.md
      - Multi-Agent Benchmark: blog/multi-agent-benchmark.md
      - Self-Evolution 30 Days: blog/self-evolution-30-days.md
      - SWE-Bench Thesis: blog/swe-bench-orchestration-thesis.md
      - COBOL Modernization: blog/cobol-modernization.md
  - Comparisons:
      - vs Conductor: compare/bernstein-vs-conductor.md
      - vs Crystal: compare/bernstein-vs-crystal.md
      - vs Dorothy: compare/bernstein-vs-dorothy.md
      - vs GitHub Agent HQ: compare/bernstein-vs-github-agent-hq.md
      - vs Paperclip: compare/bernstein-vs-paperclip.md
      - vs Parallel Code: compare/bernstein-vs-parallel-code.md
      - vs Single Agent: compare/bernstein-vs-single-agent.md
      - vs Stoneforge: compare/bernstein-vs-stoneforge.md
      - Competitive Matrix: competitive-matrix.md
  - Decisions:
      - Agent Lifecycle: decisions/001-agent-lifecycle.md
      - UX and Distribution: decisions/002-ux-and-distribution.md
      - Self-Evolution: decisions/003-self-evolution.md
      - File-Based State: decisions/004-file-based-state.md
      - Short-Lived Agents: decisions/005-short-lived-agents.md
      - No Embedded LLM: decisions/006-no-embedded-llm.md
      - Pluggy Plugin System: decisions/007-pluggy-plugin-system.md
      - Click for CLI: decisions/008-click-for-cli.md
  - Contributing: CONTRIBUTING.md
  - Audit: AUDIT.md
  - Benchmarks: BENCHMARKS.md
  - Agentic Manifesto: AGENTIC_MANIFESTO.md

docs_dir: docs
strict: false