whatisgithub

What is warden?

domdoss/warden — explained in plain English

Analysis updated 2026-05-18

20TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

A personal AI assistant that runs on your desktop with full access to your browser, email, and terminal, coordinating a small local model with larger cloud specialists.

Mindmap

mindmap
  root((Warden))
    What it does
      Desktop AI assistant
      Controls browser and terminal
      Local plus cloud models
    Tech stack
      TypeScript and Node.js
      Ollama
      SQLite
      MCP
    Use cases
      Personal automation agent
      Delegated research tasks
      Live agent dashboard
    Audience
      Developers
      AI power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a personal AI agent locally that can browse the web, manage email, and control your desktop.

USE CASE 2

Delegate research or writing tasks to a cloud AI model while a small local model supervises progress.

USE CASE 3

Automate multi-step tasks like planning, revising, and following up without repeating instructions each step.

USE CASE 4

Watch AI agents work in real time through a live dashboard instead of a running chat log.

What is it built with?

TypeScriptNode.jsOllamaSQLiteMCP

How does it compare?

domdoss/wardenadrianhajdin/job_pilotanshaneja5/skyline-run
Stars202020
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardmoderate
Complexity4/54/52/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Runs with full user-account access and no sandbox, requires Ollama for local models plus configuration of cloud model access for the specialist agents.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

So what is it?

Warden is a personal AI assistant that runs directly on your own desktop computer, using local AI models for quick tasks and reaching out to larger cloud models for harder ones, all inside one ongoing conversation. It can browse the internet using your real, already logged in browser, control your mouse and keyboard, run shell commands, and read and send your email. The project's own README opens with a strong safety warning that is worth repeating plainly: Warden runs with the same access as your regular user account, with no sandbox or container separating it from the rest of your system. Because it can execute commands, browse the web, and read messages, a mistake by the AI model, or a malicious webpage or email it processes, could potentially do anything you yourself could do from a terminal. The author explicitly warns against running it on a computer you care about unless you understand and accept that risk, while also noting they personally run it day to day on their own laptop and desktop. The design is built around a small, cheap AI model called the orchestrator, which is the only part you actually talk to. Rather than doing the work itself, the orchestrator figures out what you want and hands the job to one of several specialist AI agents: one that handles heavy research and generation using a large cloud model, one for email and calendar, one for scheduling, one for managing projects, and one for reviewing other agents' work. The orchestrator then checks in on each specialist roughly every thirty seconds, watching whether it is on track, going off course, or stuck in a loop, and can stop and reassign a job if something goes wrong. Finished results land in an internal inbox, which the orchestrator reads through and reports back to you in a single conversational voice, so you only see completed results rather than a stream of behind-the-scenes chatter. It is built with TypeScript and Node.js, uses Ollama to run local models, SQLite for its data, and the Model Context Protocol for connecting extra tools, with a web dashboard for watching what its agents are doing in real time. This project is a fork of an existing project called dockbox.dev. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain the risks described in Warden's README before I consider running it on my own computer.
Prompt 2
Walk me through how Warden's orchestrator delegates work to specialist agents like Atlas and Iris.
Prompt 3
Show me how to set up Warden locally with Ollama for the local orchestrator model.
Prompt 4
Explain how Warden's 30-second monitor tick decides whether a background agent is stuck or on track.

Frequently asked questions

What is warden?

A personal AI assistant that runs on your desktop with full access to your browser, email, and terminal, coordinating a small local model with larger cloud specialists.

What language is warden written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Ollama.

What license does warden use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

How hard is warden to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is warden for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.