mkdocs.yml

site_name: Repowire
site_description: Local-first mesh for live AI coding-agent sessions across Claude Code, Codex, OpenCode, Pi, and human control surfaces.
site_url: https://docs.repowire.io/
repo_url: https://github.com/prassanna-ravishankar/repowire
repo_name: prassanna-ravishankar/repowire
edit_uri: edit/main/docs/
copyright: MIT licensed.

docs_dir: docs
site_dir: site

# Fail the build on broken links, missing nav entries, or duplicate slugs.
strict: true

theme:
  name: material
  language: en
  font:
    text: Inter
    code: JetBrains Mono
  logo: assets/logo-mark.svg
  favicon: assets/favicon.ico
  palette:
    - scheme: default
      primary: custom
      accent: custom
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    - scheme: slate
      primary: custom
      accent: custom
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode
  features:
    - navigation.instant
    - navigation.tracking
    - navigation.indexes
    - navigation.top
    - toc.follow
    - content.code.copy
    - content.code.annotate
    - content.action.edit
    - search.suggest
    - search.highlight
    - search.share

extra_css:
  - stylesheets/repowire-cobalt.css

plugins:
  - search

markdown_extensions:
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - tables
  - toc:
      permalink: true
      toc_depth: 3
  - pymdownx.details
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true

extra:
  social:
    - icon: material/transit-connection-variant
      link: https://repowire.io/dashboard
      name: Relay dashboard
    - icon: fontawesome/brands/github
      link: https://github.com/prassanna-ravishankar/repowire
    - icon: material/tag-outline
      link: https://github.com/prassanna-ravishankar/repowire/releases

nav:
  - Home: index.md
  - Start:
      - start/index.md
      - Install: start/install.md
      - Setup: start/setup.md
      - First ask: start/first-ask.md
      - Compare:
          - start/compare/index.md
          - vs Happy: start/compare/happy.md
          - vs cloud coding services: start/compare/cloud-coding.md
          - vs Memory Bank: start/compare/memory-bank.md
          - vs Claude Squad: start/compare/claude-squad.md
          - vs Gastown: start/compare/gastown.md
  - Use:
      - use/index.md
      - Features:
          - use/features/index.md
          - Connect:
              - Claude Code: use/features/connect-claude-code.md
              - Codex: use/features/connect-codex.md
              - OpenCode: use/features/connect-opencode.md
              - Pi: use/features/connect-pi.md
          - Dashboard: use/features/dashboard.md
          - Telegram: use/features/telegram.md
          - Slack: use/features/slack.md
          - Attachments: use/features/attachments.md
          - Scheduling: use/features/scheduling.md
          - Jobs: use/features/jobs.md
          - Spawning: use/features/spawning.md
          - Orchestration: use/features/orchestration.md
          - Relay access: use/features/relay-access.md
          - Session sharing: use/features/session-sharing.md
          - Memory: use/features/memory.md
          - Skills: use/features/skills.md
      - Workflows:
          - use/workflows/index.md
          - Multi-repo coordination: use/workflows/multi-repo.md
          - Cross-agent review: use/workflows/cross-agent-review.md
          - Orchestrator coordination: use/workflows/orchestrator-coordination.md
          - Divergent ideation: use/workflows/divergent-ideation.md
          - Worktree isolation: use/workflows/worktree-isolation.md
          - Mobile mesh management: use/workflows/mobile-mesh.md
          - Infrastructure-as-peer: use/workflows/infra-as-peer.md
          - Overnight autonomy: use/workflows/overnight-autonomy.md
  - Concepts:
      - concepts/index.md
      - Peers and circles: concepts/peers-and-circles.md
      - Sessions: concepts/sessions.md
      - Agent backends: concepts/agent-backends.md
      - Bridges: concepts/bridges.md
      - Transports: concepts/transports.md
      - Message types: concepts/message-types.md
      - Jobs and schedules: concepts/jobs-and-schedules.md
      - Personas: concepts/personas.md
      - Peer identity lifecycle: concepts/peer-identity-lifecycle.md
      - Lazy repair: concepts/lazy-repair.md
      - Control surfaces: concepts/control-surfaces.md
      - Human inbox: concepts/human-inbox.md
      - Orchestrator pattern: concepts/orchestrator.md
      - Session-native roadmap: concepts/session-native-roadmap.md
  - Reference:
      - reference/index.md
      - MCP tools: reference/mcp-tools.md
      - Relay MCP and OAuth: reference/relay-mcp.md
      - CLI: reference/cli.md
      - Configuration: reference/configuration.md
      - HTTP API: reference/http-api.md
      - WebSocket events: reference/websocket-events.md
      - Hook payloads: reference/hook-payloads.md
  - Operate:
      - operate/index.md
      - Architecture: operate/architecture.md
      - Daemon: operate/daemon.md
      - Relay: operate/relay.md
      - Transports: operate/transports.md
      - State and storage: operate/state-and-storage.md
      - Auth and security: operate/security.md
      - Deployment: operate/deployment.md
  - Support:
      - Troubleshooting:
          - troubleshooting/index.md
          - Hooks not firing: troubleshooting/hooks.md
          - Daemon unreachable: troubleshooting/daemon.md
          - Ghost peers: troubleshooting/ghost-peers.md
          - Channel-mode auth: troubleshooting/channel-auth.md
          - Relay key rotation: troubleshooting/relay-keys.md
          - Diagnostic commands: troubleshooting/diagnostics.md
      - Contributing:
          - contributing/index.md
          - Development setup: contributing/development-setup.md
          - Running tests: contributing/running-tests.md
          - Documentation standards: contributing/documentation-standards.md
          - Release and versioning: contributing/versioning.md
          - Pre-PR hygiene: contributing/pre-pr-hygiene.md
          - Adding a backend: contributing/adding-a-backend.md
          - Design system: contributing/design-system.md
          - Design notes:
              - contributing/design-notes/index.md
              - Mesh command UX contract: contributing/design-notes/mesh-command-ux.md
              - Tracked work lifecycle: contributing/design-notes/tracked-work-lifecycle.md
              - Persona routing: contributing/design-notes/persona-routing.md
              - Mesh memory: contributing/design-notes/mesh-memory.md
              - Session binding contract: contributing/design-notes/session-binding-contract.md
              - Claude Code plugin packaging: contributing/design-notes/claude-code-plugin-packaging.md
          - License: contributing/license.md