DAWSON + Beakshield

A self-hosted AI ecosystem for persistent agents, shared knowledge, and safe local automation.

DAWSON is the local AI orchestration server. Beakshield is the cross-platform companion application that makes it approachable, configurable, and visible.

Self-hosted Open Source Swift Server Kotlin Multiplatform
DAWSON Mascot

Two Parts, One Kingdom

DAWSON

DAWSON

DAWSON is the orchestration layer: a self-hosted agent server designed for persistent coordination, shared memory, permission-aware tools, reusable skills, and safe automation.

Persistent Orchestrator Dedicated Squirebots Shared MemPalace Claude Skills Permission-Aware Tools Secure WebSocket
Beakshield

Beakshield

Beakshield is the companion application: the interface for chatting with agents, configuring providers, reviewing permissions, managing workspaces, and eventually observing the entire AI kingdom.

Agent Conversations Provider Management Permission Modes Workspace Config System Settings Future Knowledge Browser

Beakshield: The Command Center

Beakshield gives DAWSON a clean, approachable interface. Instead of managing everything through terminals and configuration files, users can connect to their DAWSON server, start Squirebot conversations, configure providers, adjust permission modes, and manage system settings from one place.

Agent Conversations

Every chat runs through its own dedicated Squirebot. Conversations remain focused while still benefiting from shared DAWSON knowledge.

Working

Security Made Visible

Permission modes, directory workspaces, and access boundaries are exposed through the interface so the user can control what each agent is allowed to do.

Working

Provider Management

Configure OpenAI, Anthropic, and Ollama providers from Beakshield.

Working

System Configuration

Manage DAWSON server settings, connection details, and system behavior through the app.

Working

Permission Modes

Permission modes determine what an agent is allowed to do-at this moment. Modes can be adjusted at any point during a conversation, allowing agents to move seamlessly from simple discussion to complex engineering workflows without starting over.

Egg Mode

Egg Mode

Conversation only. Designed for questions, brainstorming, writing, and planning.

Capabilities

  • Workspace Read
  • Workspace Write
  • Command Execution
  • Elevated (sudo)

Typical Uses

  • General questions
  • Writing & brainstorming
  • Programming advice
  • Architecture discussions
Fledgling Mode

Fledgling Mode

Safely inspect approved workspaces while requiring approval before making changes.

Capabilities

  • Workspace Read
  • Workspace Write Approval
  • Command Execution
  • Elevated (sudo)

Typical Uses

  • Repository exploration
  • Code reviews
  • Documentation analysis
  • Project understanding
Warrior Mode

Warrior Mode

Trusted development mode for building and maintaining projects inside approved workspaces.

Capabilities

  • Workspace Read
  • Workspace Write
  • Command Execution
  • Elevated (sudo)

Typical Uses

  • Software development
  • Refactoring
  • Website creation
  • Documentation updates
Ultimate Mode

Ultimate Mode

Maximum trust for complex engineering workflows requiring unrestricted host interaction.

Capabilities

  • Workspace Read
  • Workspace Write
  • Command Execution
  • Elevated (sudo)

Typical Uses

  • Advanced automation
  • System administration
  • Large engineering workflows
  • Complex multi-step tasks

DAWSON: The Orchestrator

DAWSON is designed as a persistent AI harness rather than a throwaway chat wrapper. It coordinates agents, manages tools, connects to local and frontier models, integrates shared memory, and exposes its capabilities through Beakshield.

Persistent Orchestrator

Dawson is intended to become the long-running primary agent that coordinates specialized agents, maintains awareness of the system, and eventually manages longer-running workflows.

In Progress

Dedicated Squirebots

Each conversation creates a dedicated Squirebot: a focused, task-oriented agent designed to answer questions, complete work, and contribute useful knowledge back to the shared palace.

Working

Shared Knowledge

DAWSON integrates MemPalace directly so agents can draw from and contribute to a shared persistent knowledge base.

Working

Claude Skills

Reusable Claude Skills provide structured expertise without stuffing every prompt with specialized instructions.

Working

Flexible Security

Chats operate under configurable permission modes and directory workspaces, allowing access to be expanded or restricted based on the task.

Working

Beakshield Companion

Beakshield provides the primary user experience for DAWSON, including chat, provider management, permissions, and system configuration.

In Development

How the System Fits Together

User

User

Beakshield

Beakshield

Secure WebSocket

Secure WebSocket

DAWSON Server

DAWSON Server

Agents & Tools

Agents & Tools

  1. The user interacts through Beakshield.
  2. Beakshield connects securely to DAWSON.
  3. DAWSON creates or manages the relevant Squirebot.
  4. The agent uses configured providers, tools, skills, and memory.
  5. Permission modes and workspace boundaries control what the agent may access.
  6. Useful knowledge can be retained through shared memory.

Project in Action

Beakshield Home

Central Dashboard

Starting point for chats, agents, and system features.

Chat Interface

Chat Interface

Dedicated conversations with model selection and permissions.

System Settings

System Settings

Configure DAWSON connectivity and system behavior.

Provider Config

Provider Configuration

Manage OpenAI, Anthropic, Ollama, and other providers.

Current Status

✓ Working

  • Multi-agent architecture
  • Dedicated chat agents
  • Shared MemPalace integration
  • Claude Skills integration
  • Permission-aware security
  • OpenAI / Anthropic / Ollama
  • Secure WebSocket communication
  • Persistent chat storage
  • Cross-platform Beakshield

🔄 In Progress

  • Persistent DAWSON orchestrator
  • Beakshield dashboard
  • Tools expansion
  • UI refinement
  • Chat configuration

⬜ Planned

  • User profiles
  • Knowledge browser
  • Background tasks
  • Live monitoring
  • Royal Decrees
  • Page orchestration
  • Voice interaction
  • Expanded automation

Development Roadmap

Foundation

Mostly Working

  • Agent execution
  • Secure communication
  • Chat persistence
  • Provider support
  • Permission modes
  • Beakshield app foundation

Visibility

Planned / In Progress

  • Knowledge browser
  • Memory inspection
  • Agent visualization
  • Live monitoring
  • System dashboard

Orchestration

Planned

  • Background tasks
  • DAWSON coordinator
  • Page orchestration
  • Workflow automation
  • Royal Decrees

Interaction

Planned

  • Voice interaction
  • Local automation
  • More providers
  • User profiles

Built Around Permission-Aware Control

DAWSON is designed to avoid giving agents unrestricted access by default. Conversations operate through configurable modes and attached workspaces, making access explicit and adjustable as the task changes.

  • ✓ Permission modes
  • ✓ Workspace isolation
  • ✓ Approval-aware tool execution
  • ✓ Secure WebSocket communication
  • ✓ Local-first operation
  • ✓ Visible configuration
Security Shield

Built for Users. Open for Engineers.

DAWSON is meant to be useful for everyday users while remaining approachable for engineers who want to inspect, extend, and experiment with the platform.

Swift Server

DAWSON's core server is built in Swift and handles agent execution, secure communication, provider integration, tools, skills, memory, and workspace-aware access.

Kotlin Multiplatform Client

Beakshield is built with Kotlin Multiplatform, allowing interface and feature work to be shared across supported platforms with less platform-specific duplication.

Extensible Architecture

Tools, skills, providers, memory, and future decrees are intended to be expandable without turning the project into a closed black box.

Get Started

DAWSON and Beakshield are separate repositories, but they are designed as one ecosystem.

DAWSON

DAWSON Server

Self-hosted AI orchestration platform powering the DAWSON ecosystem.

Beakshield

Beakshield

Cross-platform companion application for managing DAWSON agents, conversations, and system configuration.