Agentic OS (agentic-os) 🧠 — Multi-Agent Orchestration Platform

A locally-hosted operating system for AI agents — an open-source GitHub repository — that coordinates opencode, Hermes Agent, and Gemini CLI into a unified dashboard with persistent memory, cron scheduling, skill execution, cost analytics, and disaster recovery.

Why Agentic OS? Most agent tools work in isolation — a terminal for coding, a separate chat for research, another for memory. Agentic OS is the control plane that unifies them: one dashboard, one memory layer, one scheduler, one skill hub. Three agents, infinite capabilities.

---

✨ Features

Category	Features
🤖 3-Agent Engine	opencode (code/DevOps), Hermes (memory/scheduling), Gemini (research/analysis) with intelligent routing
🧩 16+ Skills	Executable skill packs with eval scoring, learnings, and score history per run
🧠 Persistent Memory	SQLite FTS5 + brain/ folder — shared context read by all agents at session start
⏱ Cron Scheduler	APScheduler-powered jobs — heartbeat, memory consolidation, daily standup, DevOps audit
💰 Cost Analytics	Track spending per provider, model, agent. Free-tier alerts prevent surprise bills
📋 Audit Trail	Every action logged — chat, skill runs, settings changes, backups
💾 One-Click Backup	Full tar.gz snapshot of all configs, skills, brain, agents, prompts
📝 Prompt Library	10 reusable templates — code review, system audit, project plan, brainstorm, and more
📐 Standards System	Discover and inject coding conventions across your project
🔌 Plugin Registry	Marketplace-style plugin management (extensible via skills)
🎨 Dark/Light Theme	GitHub-style dark mode + clean light theme, toggle from sidebar
⚡ Zero API Costs	Built for free tiers — Gemini Flash, OpenRouter free models, local opencode
📋 Kanban Board	Visual task management — drag-and-drop columns, priority/status filtering, block/unblock, detail view
🎯 Goals	Project targets with progress tracking, auto-syncs to brain/active-projects.md
📓 Journal	Daily markdown entries stored as brain/journal/YYYY-MM-DD.md with full-text search
❤️ Agent Health	Real-time monitoring of opencode, Hermes, and Gemini CLI availability
🧭 Smart Router	Keyword-based task routing with confidence scoring — suggests best agent for any task
📊 Learning Analytics	Skill evaluation scores, performance trends, and historical charts
🎬 Session Replay	Browse and replay past opencode sessions from the dashboard

---

🏗 Architecture

┌──────────────────────────────────────────────────────────────┐
│                    AGENTIC OS DASHBOARD                      │
│                    FastAPI + Tailwind SPA                    │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────-┐  ┌──────────────┐  ┌──────────────────┐   |
│  │   opencode    │  │    Hermes    │  │   Gemini CLI     │   │
│  │  (Code/DevOps)│  │ (Memory/Sched│  │ (Research/Analy) │   │
│  │  File Ops)    │  │  /Channels)  │  │                  │   │
│  └──────────────-┘  └──────────────┘  └──────────────────┘   |
│                                                              │
│  ┌──────────────────────────────────────────────────────┐    │
│  │              7 CORE LAYERS (Stacked)                 │    │
│  │  Layer 7: Identity / Persona / Constitution          │    │
│  │  Layer 6: Self-Evolution + Capability Manager        │    │
│  │  Layer 5: Scheduler + Awareness + Health Guardian    │    │
│  │  Layer 4: Memory Graph + Memory Consolidation        │    │
│  │  Layer 3: Skills Hub + Eval + Learnings Loop         │    │
│  │  Layer 2: Business Brain + Context Folders           │    │
│  │  Layer 1: Agent Router + Standards + Profiles        │    │
│  └──────────────────────────────────────────────────────┘    │
└──────────────────────────────────────────────────────────────┘

Agent Responsibilities

Agent	Role	Default Model	Provider	Cost
opencode	Code generation, DevOps, file operations	deepseek-v4-flash-free	opencode-zen	$0
Hermes Agent	Persistent memory, scheduling, messaging	Owl Alpha (1M ctx)	OpenRouter	$0
Gemini CLI	Web research, multi-modal analysis	gemini-2.5-flash	Google OAuth	$0

Routing Rules

• Code/DevOps task? → opencode
• Memory/Channel/Schedule? → Hermes Agent
• Research/Analysis? → Gemini CLI
• Complex multi-step? → Chain: Gemini researches → opencode implements → Hermes monitors/schedules

---

🚀 Quick Start

Linux/macOS

git clone https://github.com/zumayaaustin-creator/agentic-os.git
cd agentic-os
chmod +x install.sh && ./install.sh
./start.sh
# Open http://127.0.0.1:8080

Windows PowerShell

git clone https://github.com/zumayaaustin-creator/agentic-os.git
cd agentic-os
.\install.ps1
.\start.ps1
# Open http://127.0.0.1:8080

---

📋 Prerequisites

Linux/macOS

Tool	Required?	Install
Python 3.10+	✅ Required	Install from your package manager or python.org. Verify with python3 --version.
Node.js 18+	⚠ For opencode and Gemini CLI	curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - && sudo apt install -y nodejs
opencode	⚠ For code tasks	npm install -g @opencode/cli
Hermes Agent	⚠ For memory/scheduling	Follow the upstream Hermes Agent documentation. If native Windows support is unavailable, use WSL for Hermes.
Gemini CLI	⚠ For Google AI	npm install -g @google/gemini-cli

⚠ = Optional — the dashboard starts and core pages work without all agent CLIs installed. Agent-specific chat, routing, health, and skill execution features will show offline or warning status until the relevant CLI is installed and authenticated.

Windows

Tool	Required?	Install	Verify / Next Step
Python 3.10+	✅ Required	Install from python.org/downloads/windows and enable “Add python.exe to PATH” during setup.	python --version
Node.js 18+	⚠ For opencode and Gemini CLI	Install from nodejs.org.	node --version and npm --version
opencode	⚠ For code tasks	npm install -g @opencode/cli	Confirm the CLI is available in a new terminal session.
Gemini CLI	⚠ For Google AI	npm install -g @google/gemini-cli	Run gemini auth login and complete OAuth in the browser.
Hermes Agent	⚠ For memory/scheduling	Windows support must be verified separately if the upstream installer remains Bash-only.	Check the upstream Hermes Agent install docs before relying on native Windows support.

⚠ = Optional — the dashboard works with any subset of installed agents.

The PowerShell launchers resolve Python in this order: py -3.10, py -3, then python. For manual commands, prefer python -m pip install -r requirements.txt and python server.py --port 8080 so the same interpreter runs both dependency installation and the server.

PowerShell execution policy: if you use PowerShell scripts, allow local scripts for your user with Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, or run a single installer invocation with powershell -ExecutionPolicy Bypass -File .\install.ps1.

---

🔧 Configuration

Hermes (OpenRouter)

# Set your OpenRouter API key
echo 'OPENROUTER_API_KEY=sk-or-v1-your-key-here' > ~/.hermes/.env

Gemini CLI (Google OAuth)

gemini auth login
# Complete OAuth in browser — tokens saved to ~/.gemini/oauth_creds.json

Dashboard Settings

Edit data/settings.json:

{
  "dashboard": { "port": 8080 },
  "theme": "dark",
  "agents": { "opencode": true, "hermes": true, "gemini": true }
}

---

📁 Project Structure

agentic-os/
├── server.py              # FastAPI backend (REST API)
├── requirements.txt       # Python dependencies
├── install.sh / install.ps1 # Platform installers
├── start.sh               # Launch dashboard
├── backup.sh / restore.sh # Unix disaster recovery
├── backup.ps1 / restore.ps1 # Windows disaster recovery
│
├── dashboard/             # Web frontend (SPA)
│   ├── index.html         # Entry point + sidebar
│   ├── app.js             # SPA router + theme/sidebar toggle
│   ├── api.js             # API client (all endpoints)
│   ├── styles.css         # Full dark/light theme CSS
│   ├── utils.js           # Shared utilities
│   └── pages/             # 20 page modules (13 original + 7 v0.2.0)
│       ├── dashboard.js   # Overview with stats
│       ├── skills.js      # Skill grid/list/detail
│       ├── memory.js      # Brain file editor
│       ├── chat.js        # Multi-agent chat
│       ├── scheduler.js   # Cron job manager
│       ├── audit.js       # Activity trail
│       ├── cost.js        # Cost analytics charts
│       ├── plugins.js     # Plugin marketplace
│       ├── backups.js     # Backup/restore UI
│       ├── prompts.js     # Template library
│       ├── standards.js   # Code conventions
│       ├── settings.js    # Config editor
│       ├── setup-wizard.js  # Guided setup
│       ├── kanban.js      # ▸ Kanban Board (v0.2.0)
│       ├── goals.js       # ▸ Goals (v0.2.0)
│       ├── journal.js     # ▸ Journal (v0.2.0)
│       ├── agent-health.js # ▸ Agent Health (v0.2.0)
│       ├── smart-router.js # ▸ Smart Router (v0.2.0)
│       ├── learning-analytics.js # ▸ Learning Analytics (v0.2.0)
│       └── session-replay.js # ▸ Session Replay (v0.2.0)
│
├── brain/                 # Shared context (all agents read)
│   ├── business-brain.md  # Current project context
│   ├── memory.md          # Accumulated knowledge
│   ├── recent-decisions.md
│   ├── active-projects.md
│   ├── identity.md
│   ├── constitution.md
│   └── journal/           # Daily markdown entries (YYYY-MM-DD.md)
│
├── skills/                # 16 executable skills
│   ├── devops-audit/      # GCP/CloudMart infra audit
│   ├── heartbeat/         # 5-min health check
│   ├── content-draft/     # Blog/newsletter writing
│   ├── code-review/       # PR review checklist
│   ├── research-synthesis/ # Gemini research aggregator
│   ├── daily-standup/     # Morning briefing
│   ├── meeting-minutes/   # Notes processor
│   ├── project-planner/   # Step-by-step plans
│   ├── brainstorming/     # Socratic design
│   ├── systematic-debug/  # 4-phase root cause
│   ├── memory-consolidation/ # Weekly synthesis
│   ├── backup-skill/      # Snapshot creator
│   ├── cost-analytics/    # Multi-provider cost
│   ├── tdd-cycle/         # Red-green-refactor
│   ├── goal-planner/      # Goal → steps
│   └── _template/         # Starter template
│
├── agents/                # Per-agent configs
├── scheduler/jobs/        # Cron job definitions
├── registry/              # Plugin marketplace
├── standards/             # Discover/inject conventions
├── prompts/               # 10 reusable templates
├── data/                  # Runtime data (agent-routes.json tracked; settings/cost/chat gitignored)
├── audit/                 # Activity log (gitignored)
└── backups/               # Snapshots (gitignored)

---

🆕 What's New in v0.2.0

Feature	Description
📋 Kanban Board	Visual task management with 6 columns (triage → todo → ready → in_progress → blocked → done), drag-and-drop, priority labels, filtering, and detail modals with complete/block/unblock actions
🎯 Goals	Create and track project targets with progress bars, categories, and target dates. Auto-syncs to brain/active-projects.md for agent awareness
📓 Journal	Daily markdown journal entries stored as brain/journal/YYYY-MM-DD.md. Full-text search, day streak tracking, word count
❤️ Agent Health	Real-time dashboard showing online/offline status for all 3 agents (opencode, Hermes, Gemini CLI). Auto-refresh every 5 seconds
🧭 Smart Router	Keyword-based routing engine — type a task description and get an AI-suggested agent with confidence score. Manual override available
📊 Learning Analytics	Skill evaluation scores, performance trends, and per-skill detail breakdowns with mini bar charts
🎬 Session Replay	Browse and replay past opencode sessions directly from the dashboard. View message content and timestamps

UI Modernization

• Glass morphism cards with subtle backdrop blur
• Glow borders and gradient accents on interactive elements
• Skeleton loaders with shimmer animation for async content
• Empty states with icons and contextual messages
• All CSS additions are zero-breaking — existing 13 pages and 28 endpoints unchanged

---

🎮 Usage

AI Chat

Select an agent from the sidebar → type your message → get response.

Agent	Best for	Example
opencode	"Check system status", "Deploy to GKE"	Code + terminal automation
Hermes	"What did I work on recently?", "Schedule a daily backup"	Memory recall, scheduling
Gemini	"Research latest AI agent trends", "Analyze this image"	Web research, multi-modal

Skills

Browse 16 skills from Skills Hub → click Run → monitor eval scores over time.

Scheduler

Create cron jobs: heartbeat (5 min), memory consolidation (weekly), daily standup, DevOps audit.

Cost Analytics

Track spending per provider/model/agent. Free-tier alerts warn when nearing limits.

Disaster Recovery

Create and restore local snapshots of brain/, skills/, agents/, data/, registry/, standards/, and prompts/. User-specific data/settings.json is excluded from backups.

Unix/macOS/Linux

./backup.sh
./restore.sh <backup-file>

Windows PowerShell

.\backup.ps1
.\restore.ps1 <backup-file>

Run the restore command without a backup file to list available backups.

Kanban Board (v0.2.0)

Drag tasks across columns, filter by priority/category, click to view details. Block tasks when blocked, mark complete when done.

Goals (v0.2.0)

Create goals with categories and target dates. Progress tracked via +25% increments. Completed goals auto-sync to brain context.

Journal (v0.2.0)

Write daily entries with markdown support. Auto-saves after 2 seconds. Search across all entries from the dashboard.

Smart Router (v0.2.0)

Describe a task in plain English — the router analyzes keywords and suggests the best agent. Route manually or let AI decide.

Agent Health (v0.2.0)

Monitor online status of all 3 agents in real time with 5-second auto-refresh. Health checks are filesystem-based (no subprocess calls).

Learning Analytics (v0.2.0)

View evaluation scores for all 16 skills. Trends chart shows score progression over time. Top skills ranked by performance.

Session Replay (v0.2.0)

Browse opencode session logs by date and size. Click "Replay" to view all messages in a chat-like interface.

---

📊 Comparison: Agentic OS vs Claude Agent OS (Julian Goldie)

Feature	Claude Agent OS (Video)	Agentic OS (This Project)
Core Agents	Claude + OpenClaw + Hermes	opencode + Hermes + Gemini CLI
Cost	$20/mo (Claude subscription)	$0 — all free tiers
Stack	Next.js + Tailwind	FastAPI + vanilla JS SPA
Architecture	4 layers	7 layers
Skills System	Plugin marketplace (2,000+ from Hermes)	16 curated skills + eval scoring + learnings
Memory	Obsidian vault (external)	Built-in brain/ + SQLite FTS5
Scheduler	Not shown	APScheduler cron jobs
Cost Tracking	Not shown	Built-in per-provider analytics
Backup/Restore	Not shown	One-click Unix tar.gz and Windows zip snapshots
Audit Trail	Not shown	Full activity log
Standards System	Not shown	Discover/inject conventions
Client Timeout	Not shown	200s AbortController
Kanban Board	Yes	Yes — built-in with drag-and-drop, priority, block/unblock, filters
Open Source	No (tutorial only)	MIT License

---

🧪 Tested On

• OS: Linux (Ubuntu 22.04+), macOS; Windows dashboard setup supported via PowerShell, with Hermes best used through WSL if native support is unavailable
• Python: 3.10, 3.11, 3.12
• Browsers: Chrome, Firefox, Edge
• Agents: opencode v0.8+, Hermes Agent v1.0+, Gemini CLI v1.0+

---

🤝 Contributing

1. Fork the repo
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push (git push origin feature/amazing-feature)
5. Open a Pull Request

See data/agent-routes.json for routing rules and skills/_template/ for creating new skills.

---

📄 License

MIT License — free to use, modify, and distribute.

---

Agentic OS — Built with ❤️ by Mihir Modi

📖 Read the dev.to article · Report Bug · Discussions · GitHub