AnisminOS Overview 📋
Classification: Public | Last updated: 2026-03-05
What is AnisminOS?
AnisminOS is a web-based desktop operating system UI designed for managing AI agents and their workflows. It provides a familiar desktop environment — windows, a dock, a launchpad — all running in your browser.
Purpose
AnisminOS is the central command center for a team of AI executives. It enables:
- Visual management of AI agent sessions and status
- Memory management through a PostgreSQL-backed semantic database
- Executive meetings via the Boardroom for structured collaborative decisions
- Task management through the Dispatch Board
- System monitoring including cron jobs, infrastructure, and security posture
- Settings management with a unified configuration API
Architecture
Backend: Flask (Python)
- Auto-discovery system — Apps are automatically discovered from the
apps/directory on boot - Blueprint-based routing — Each app is a self-contained Flask Blueprint
- Manifest-driven — Apps define metadata, settings, and behavior in
app.json - PostgreSQL integration — Memory app uses PostgreSQL + pgvector for semantic search
Frontend: Vanilla JavaScript
- Desktop metaphor — Windows, Dock, and LaunchPad inspired by macOS
- Iframe-based apps — Each app runs in its own sandboxed iframe
- Frame SDK — Apps communicate with the OS via
/api/frame.js - Unified theming — Global CSS custom properties via
/api/design.css
App Structure
Every app lives in apps/<app-name>/ with this layout:
apps/my-app/
├── app.json # Manifest: name, icon, settings, window size
├── routes.py # Flask Blueprint with all routes
└── templates/
└── my-app.html # App UI
Tech Stack
| Layer | Technology |
|---|---|
| Backend | Python 3, Flask |
| Database | PostgreSQL + pgvector |
| Embeddings | Google Gemini API |
| Frontend | Vanilla JS (ES6+), CSS3 |
| Markdown | Marked.js |
| Reverse proxy | Caddy |
| Process manager | systemd |
Design Language
AnisminOS uses a macOS-inspired glassmorphism aesthetic:
- Translucent backgrounds with backdrop blur
- Layered depth via shadows and stacking contexts
- Smooth transitions on all interactive elements
- Accent color:
#29b6f6(vibrant blue) on dark backgrounds
System Apps
Core
| App | Purpose |
|---|---|
| Memory 🧠 | Semantic memory database |
| Boardroom 🏛️ | Executive meeting and debate platform |
| Agents 🤖 | AI agent session dashboard |
| Cron Jobs ⏰ | Scheduled task management |
| Org Chart 📊 | Organization hierarchy viewer |
| Infrastructure 🏗️ | Server monitoring and management |
| Docs 📚 | This documentation system |
Task & Project Management
| App | Purpose |
|---|---|
| Dispatch Board 📋 | Executive task assignment and review workflow |
| Shipyard 🚢 | Bug tracker, enhancements, and changelog |
| Projects 💻 | GitHub repository integration |
Security & Access
| App | Purpose |
|---|---|
| Permissions 🔒 | User management and RBAC |
| Token Vault 🎟️ | Secure secret management (2FA-gated) |
| Elevation Manager 🔑 | Just-In-Time sudo elevation for agents |
| Scanner 🔍 | Local security pattern scanner |
Utilities
| App | Purpose |
|---|---|
| Translate 🌐 | AI shorthand → plain English |
| Files 📁 | Browser-based file explorer and editor |
| OpenClaw 🐾 | AI gateway dashboard |
| Legal ⚖️ | Privacy policy and cookie disclaimer |
Creating a New App
- Create the directory:
apps/my-app/ - Define
app.jsonwith metadata and settings - Write
routes.pyas a Flask Blueprint - Create your template importing
/api/design.cssand/api/frame.js - Restart the server — it auto-discovers the new app
See the Building Apps Guide for a full walkthrough.
AnisminOS — a visual OS for AI teams. 🐬