Monolith

Make space for what matters.

Your pages, projects and everyday tools in one self-hosted workspace.
Use the web, Windows or macOS. Connect your agents. Add the tools that fit your day.

Website · Documentation · Quickstart · Addons and Widgets · Releases

Self-hosting · MCP and CLI · Updates · Contributing

_{A connected workspace, shaped around your day. Screenshots use synthetic data.}

What is Monolith?

An idea becomes a page. A page becomes a project. Tasks need dates, records need context, and useful tools should be close to the work.

Monolith brings those pieces together. Write rich documents, organize structured information, plan projects and build a dashboard around what matters to you. Connected views use the same underlying records, so your calendar, project board and dashboard can show different perspectives on the same work.

Run it on your own infrastructure, connect browser and desktop clients, and extend it with optional addons, widgets and agent integrations.

Keep your knowledge connected

• Docs and pages — Nested pages, rich blocks, references, backlinks and inline database views.
• Databases — Typed properties, relations, saved filters and table, board and calendar views.
• Atlas — An optional visual map for exploring connections between your knowledge.
• Search and navigation — Find accessible content and arrange your sidebar around your workspace.

Turn plans into progress

• Projects — Plan in boards, lists, timelines and Gantt views.
• Actions — Focus on Today, Upcoming, High priority and Completed.
• Calendar — Bring dated records, events and subscriptions into month, week and agenda views.
• Rooms — Keep workspace conversations close to the work.
• Automations — Connect workflow triggers and actions, then inspect execution history.

Make your workspace your own

Start with seven native sections: Calendar, Projects, Actions, Rooms, Docs, Dashboard and Databases. Reorder navigation, choose light or dark appearance and add the tools you need.

Addons and Widgets separates installing a package on the host from enabling it in a workspace. Filter the shop by type, category and installation state; configure widgets in an overlay, add them to the dashboard or pin supported widgets to the sidebar.

Configured hosts can use a signed GitHub Releases catalog for versioned downloads, progress, compatibility checks and package recovery. Packages can have independent versions while sharing a repository. The public website is a catalog; installation happens inside your Monolith host.

Work with your agents

Connect Codex, Claude Code, OpenClaw, Cursor or another stdio MCP client to your workspace. Monolith’s MCP bridge and JSON CLI expose tools for pages, canonical documents, databases, records, projects, tasks and calendar events.

The bridge starts in read mode. Enable writes deliberately; your account permissions and document revision checks still apply. The separate Agents addon organizes worker-backed assignments and is not required to use MCP.

Build and sign in before generating configuration. Follow the MCP and CLI guide for authentication, permissions and client setup.

Get started

• Browser — Run a local development workspace or connect to your configured host.
• Desktop — Download the Windows x64 installer or universal macOS disk image.
• Self-host — Download a Linux server image and the setup kit from the release, then follow the installation guide.

Download 0.1.9: Windows, macOS, Linux x64/ARM64, 14 addon and widget packages, and the CLI/MCP bridge. This release adds a polished calendar event popover and consistent controls, improves download progress, and fixes Windows rollback when installation paths are redirected. Automatic updates use authenticated downloads, progress and rollback. Windows installers remain unsigned and macOS is not notarized. Clients from 0.1.3 and preview builds need this installer once; 0.1.7 and 0.1.8 clients update automatically. Servers upgrading from before 0.1.8 need the calendar schema migration first. See installation instructions and checksums.

pnpm install --frozen-lockfile
pnpm build
pnpm local:setup
pnpm db:push
pnpm dev

Your first workspace

1. Capture an idea. Create a page in Docs, give it a title and add the context you want to keep.
2. Put work around it. Create a project, add an action and give it a date. Explore the related project and calendar views.
3. Shape your day. Arrange the Dashboard, reorder the sidebar and preview a widget in Addons and Widgets.

Follow the first-workspace walkthrough for the next steps.

Updates and recovery

Windows, macOS and the single-host Docker server have a GitHub Releases update system with notifications, download progress, signed package verification and recovery to a previous runtime.

Automatic downloads and automatic installation are separate settings. Desktop updates respect saved-work checks; server installation uses a UTC maintenance window and health checks. Schema-changing releases require a planned migration: runtime rollback does not reverse database changes.

Automatic downloads and installation are enabled by default in updater-enabled clients. The hosted server requires the external supervisor. Update authentication uses Monolith’s release key independently of optional OS publisher signing. Read the update guide.

Documentation

The workspace maintains English, Malay, Simplified Chinese and Traditional Chinese locale packs. The public docs are currently in English.

Architecture

 Browser          Windows / macOS          Agent clients
    |                    |                       |
    |                    |                 MCP / JSON CLI
    +--------------------+-----------------------+
                         | HTTPS
                   Monolith gateway
                    /            \
          Canonical documents   Domain API
                    \            /
                     PostgreSQL

See Architecture for repository paths and the boundaries between clients, host services and optional workers.

Development

Use the pinned pnpm version and follow the development guide. Run checks appropriate to your change:

pnpm core:check
pnpm typecheck
pnpm build
pnpm gateway:test
pnpm agent:test

Native packaging requires the matching platform. OS signing credentials are optional in the explicit unsigned installer mode; update manifests still require the release key. The public website has its own build and checks:

pnpm site:build
pnpm site:check
pnpm site:test

For contributions, describe the problem in a GitHub issue, make a focused change and include relevant validation. Keep addon secrets on the host and user data outside replaceable application packages.

pnpm monolith addons create yourname--reading-list
pnpm install
pnpm --filter @monolith/yourname--reading-list build
pnpm release:addons yourname--reading-list

License and attribution

Maintained by Monolith contributors. See LICENSE and the licenses and notices shipped with each package. Source and license information is included in the documentation.

BlockSuite, Yjs and other dependencies retain their own notices. The Monolith mark and cover are original project assets.