Skip to content

Releases: jherforth/Monastery

v0.1.0-alpha

17 Jun 14:38
@jherforth jherforth
v0.1.0-alpha
2ad7bba

Choose a tag to compare

View all tags
v0.1.0-alpha Pre-release
Pre-release

Monastery v0.1.0-alpha

Release Date: 2026-06-17

The inaugural alpha release of Monastery — a self-hosted sanctuary for AI-assisted coding. Connect your LLMs, manage projects with Git, deploy to your own infrastructure, and dispatch specialized AI agents - expect little from this initial offering.

Core Platform

Multi-LLM Support

  • Connect any OpenAI-compatible endpoint (Ollama, vLLM, DeepSeek, OpenAI, Groq, etc.)
  • Add, validate, and manage multiple endpoints in Settings
  • Auto-select active endpoint; mark favorites
  • Local endpoint detection with "local" badge

Chat Interface

  • Real-time SSE streaming with markdown rendering
  • Code block syntax highlighting with copy buttons
  • File attachment support (images, code files)
  • Auto-apply AI-generated code blocks to project files
  • Shell command detection and execution
  • Reasoning window — collapsible panel showing LLM thinking/reasoning tokens, capped at ~12 rows, scrollable
  • Stop/interrupt generation mid-stream
  • Welcome screen with suggested prompts

Project Management

  • Multi-project support with SQLite persistence
  • File tree explorer in sidebar
  • Multi-tab code editor (Monaco-based, custom Monastery dark theme)
  • File read/write via backend API
  • Preview pane for live output

Session Persistence

  • Chat sessions tied to projects
  • Create, switch, and delete sessions
  • Message history stored in SQLite via backend

Git Integration

Four Git forges supported with full CRUD + test workflow:

Forge Type Setup
GitHub Cloud API key (repo scope)
GitLab Cloud / Self-hosted API key (api, read_user)
Forgejo Self-hosted URL + API key
Gitea Self-hosted URL + API key

Features

  • Wizard-style connection setup with token guide links
  • Browse repositories with branch selection
  • Clone repos as new Monastery projects
  • Push projects to new repos on any forge
  • Git status display (branch, ahead/behind, changed files)
  • Auto-commit with snapshot creation before push

Agent System

Six built-in specialized AI agents, each with a tuned system prompt:

Agent Icon Role
Architect 🏗️ Plans project structure, chooses patterns
Coder 💻 Writes and edits code files
Reviewer 🔍 Code review — bugs, security, anti-patterns
Tester 🧪 Writes unit/integration tests
Documenter 📝 README, API docs, inline comments
Deployer 🚀 Dockerfile generation, deployment config

Invocation Methods

  • Chat quick-actions — collapsible button row above chat input (toggle with Agents header)
  • Editor toolbar — Explain / Refactor / Add Tests buttons dispatch Reviewer, Coder, and Tester with current file context
  • Natural language — ask the main chat to use an agent

How It Works

  1. Agent receives its system prompt + full project context (capped at 200KB)
  2. LLM streams response via SSE with reasoning support
  3. Response appears as live-streamed assistant message in chat

Self-Host Deployment

Hosting Services (Settings)

Connect to your self-hosted infrastructure:

Service Type Use
Dokploy PaaS Deploy apps, databases, Docker containers
Coolify PaaS Vercel/Netlify alternative for self-hosted
Pocketbase Backend Database, auth, file storage

Each service card shows connection status:

  • ⚠ Not Verified — saved but not validated
  • ✓ Connected — validated successfully
  • ✗ Failed — error with message

Self-Host Wizard (Ctrl+Shift+D)

One-click deployment modal:

  • Auto-detects connected platforms and database backends
  • Framework detection from package.json (Next.js, Vite, React, Vue, Express, Fastify, Node)
  • Auto-generates optimized multi-stage Dockerfile if none exists
  • Creates application on Dokploy or Coolify
  • Triggers deployment and returns dashboard URL
  • Configurable app name and port

Snapshot Version Control

  • Create named snapshots of entire project state
  • Auto-snapshots before git commits
  • List, view, diff, and restore snapshots
  • Revert to any snapshot from chat markers

Sidebar

Four-tab collapsible left panel:

Tab Content
Files Project file tree with sync status indicators
Sessions Chat history with create/delete
Agents 6 built-in agents with descriptions, tool badges, and idle status
Integrations Live status of LLM endpoints, Git forges, and Hosting Services with count badges

Settings Modal

Three-tab configuration center:

Tab Content
LLM Endpoints Add/validate/delete OpenAI-compatible endpoints
Git Forges Connect GitHub, GitLab, Forgejo, Gitea
Hosting Services Connect Dokploy, Coolify, Pocketbase

Architecture

┌──────────────────────────────────────────────────┐
│                   Browser (React + Vite)          │
│  ┌─────────┐ ┌──────────┐ ┌───────────────────┐  │
│  │ Chat    │ │ Editor   │ │ Preview           │  │
│  │ +Agents │ │ +Toolbar │ │                   │  │
│  └─────────┘ └──────────┘ └───────────────────┘  │
│  ┌────────────────────────────────────────────┐  │
│  │ Sidebar (Files/Sessions/Agents/Integrations)│  │
│  └────────────────────────────────────────────┘  │
└────────────────────┬─────────────────────────────┘
                     │ REST + SSE
┌────────────────────▼─────────────────────────────┐
│              Rust Backend (Axum)                  │
│  ┌──────────┐ ┌────────┐ ┌───────────────────┐   │
│  │ Chat     │ │ Agents │ │ Deploy (Coolify/   │   │
│  │ Stream   │ │ Run    │ │ Dokploy)           │   │
│  └──────────┘ └────────┘ └───────────────────┘   │
│  ┌──────────┐ ┌────────┐ ┌───────────────────┐   │
│  │ Git      │ │Hosting │ │ Snapshots         │   │
│  │ Forges   │ │Services│ │                   │   │
│  └──────────┘ └────────┘ └───────────────────┘   │
│  ┌──────────────────────────────────────────┐    │
│  │ SQLite (endpoints, projects, sessions,    │    │
│  │  git_connections, hosting_connections)    │    │
│  └──────────────────────────────────────────┘    │
└──────────────────────────────────────────────────┘

Tech Stack

  • Frontend: React 18, TypeScript, Vite, Tailwind CSS, Zustand, SWR, Monaco Editor
  • Backend: Rust, Axum, SQLx, async-openai, reqwest
  • Database: SQLite
  • Streaming: Server-Sent Events (SSE) with reasoning support
  • Container: Docker Compose

What's Next (v0.2.0)

  • External agent support (Hermes, Open Claw)
  • Deployment progress streaming in wizard
  • Environment variable management for deployments
  • Pocketbase schema auto-generation
  • Agent pipeline orchestration (chain agents together)
  • Multi-model agent support (use different LLMs per agent)

Documentation

  • README.md — Project overview and quick start
  • ARCHITECTURE.md — High-level architecture
  • PROJECT_VISION.md — Design philosophy
  • docs/AGENTS.md — Agent system documentation
  • docs/SELF_HOST_WIZARD_PLAN.md — Deployment wizard plan
  • packages/web-ui/README.md — Frontend documentation
Loading