Clone the repository

<div align="center">
  <img src="apps/web/public/logo.png" alt="OpenLoaf Logo" width="120" />
  <h1>OpenLoaf</h1>
  <p><strong>Open-Source AI Productivity Desktop — Project-Centric, Multi-Agent, Local-First</strong></p>
  <p>Each project gets its own AI agent team, memory, and skills. Projects link to share knowledge. A Secretary Agent orchestrates everything. The agent runtime, memory system, skills loading, and tool routing are native OpenLoaf capabilities - not a thin wrapper around Claude Code. Your data never leaves your device.</p>

  <p>💬 AI Secretary &nbsp;|&nbsp; 📁 Independent Projects &nbsp;|&nbsp; 🔗 Project Linking &nbsp;|&nbsp; 🤖 Multi-Agent &nbsp;|&nbsp; 🎨 Canvas &nbsp;|&nbsp; 📧 Email &nbsp;|&nbsp; 📅 Calendar &nbsp;|&nbsp; 📋 Tasks</p>

  <blockquote><strong>One app, multiple project windows. Each project has its own AI team. Link projects to share knowledge. A Secretary Agent ties it all together — 100% local.</strong></blockquote>

  <a href="https://github.com/OpenLoaf/OpenLoaf/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPLv3-blue.svg" alt="License" /></a>
  <a href="https://github.com/OpenLoaf/OpenLoaf/releases"><img src="https://img.shields.io/github/v/release/OpenLoaf/OpenLoaf?label=latest" alt="Release" /></a>
  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-brightgreen" alt="Platform" />

  <br /><br />
  <a href="https://github.com/OpenLoaf/OpenLoaf/releases/latest">📥 Download for macOS / Windows / Linux</a>
  <br /><br />
  <strong>English</strong> | <a href="docs/README.md">简体中文</a> | <a href="docs/README_ja.md">日本語</a>
</div>

---

> **⚠️ This project is in active development. Features and APIs may change — use in production with caution.** Encountered a bug or have an idea? Submit feedback via the app's built-in feedback button.

---

## About

OpenLoaf is a local-first AI productivity desktop app built around **projects as independent workspaces**. Each project opens in its own dedicated window with a full-featured environment: AI assistant, file tree, terminal, task board, and canvas.

A **Secretary Agent** lives in the main window as your personal assistant — it can answer questions, manage your calendar and email, and route complex tasks to the right project's AI agent. For cross-project work, projects **link** to each other to share memory and skills.

> **Built natively into OpenLoaf:** the Secretary / Project / Worker agent system, project memory injection, skills discovery, runtime tool execution, and multi-window orchestration are all part of OpenLoaf's own product architecture - not a Claude Code reskin or thin wrapper.

### How It Works

```
You (the Boss)
  │
  ▼
Secretary Agent (Main Window — your personal assistant)
  │
  ├── Simple tasks → handles directly
  ├── Single-project tasks → spawns a Project Agent
  └── Cross-project tasks → spawns multiple Project Agents in parallel
        │
        └── Project Agent (Project Window)
              │
              └── Worker Agents (explore, plan, code...)
```

**Main Window** — your command center:
- AI Secretary for global tasks (calendar, email, cross-project queries)
- Activity timeline showing recent projects, conversations, and canvases
- Project grid to browse and open projects

**Project Window** — each project gets its own:
- Dedicated AI assistant with project-specific memory and skills
- File explorer, terminal, task board, canvas
- Links to other projects (their memory and skills are auto-injected)

<div align="center">
  <img src="docs/screenshots/overview.png" alt="OpenLoaf Overview" width="800" />
</div>

---

## Features

### Multi-Agent Architecture

OpenLoaf's AI isn't a single chatbot — it's a **layered agent system** modeled after how companies work and built specifically for OpenLoaf's project-centric workflow:

| Agent | Role | Scope |
|-------|------|-------|
| **Secretary** | Your personal assistant in the main window | Global: calendar, email, project routing, cross-project queries |
| **Project Agent** | Dedicated assistant per project | Project: files, code, docs, terminal, tasks |
| **Worker Agents** | Specialized sub-agents spawned on demand | Focused: explore, plan, code, review |

The Secretary decides the most efficient path — simple questions get answered immediately, project-specific tasks get routed to the right Project Agent, and complex multi-project tasks spawn parallel agents. Agent roles, project routing, memory injection, skills loading, MCP access, and runtime tool execution are first-class OpenLoaf capabilities rather than a thin layer on top of Claude Code.

### Independent Project Windows

Each project opens in its own window (Electron) or browser tab (web). No context switching — work on multiple projects simultaneously with full isolation.

Projects are organized by **user-defined type labels** (e.g., "code", "docs", "knowledge base") which serve as visual groupings in the project grid. Types are just labels 

... (truncated)