diff --git a/.gitignore b/.gitignore
index acbfe0e..f25e75c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -7,3 +7,7 @@ node_modules/
.DS_Store
*.tar.gz
backups/*.tar.gz
+audit/*
+data/settings.json
+data/chat-history.json
+data/cost-history.json
diff --git a/AGENTS.md b/AGENTS.md
index 4a5a7ac..3e1c865 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,6 +14,7 @@ Your role is to act as the **kernel** of this system: route tasks to the right a
|-------|-------|
| **Name** | Agentic OS |
| **Location** | `/home/mihir/Desktop/Agentic OS Project/` |
+| **GitHub** | [github.com/modimihir07/agentic-os](https://github.com/modimihir07/agentic-os) |
| **Author** | Mihir N Modi (Gujarat, India โ BTech CSE 1st year) |
| **Created** | May 17, 2026 |
| **License** | MIT |
@@ -314,7 +315,7 @@ Your role is to act as the **kernel** of this system: route tasks to the right a
| **Active Project** | CloudMart โ GCP DevOps multi-region e-commerce platform |
| **Other Projects** | AgriAssist AI, Hermes Agent/OpenClaw, EROS Wellness AI, Java OOP practice |
| **CLI Tools Available** | opencode, Hermes Agent, Gemini CLI |
-| **Preferred Model** | deepseek-v4-flash-free |
+| **Preferred Model** | Hermes: Owl Alpha (OpenRouter, free), opencode: deepseek-v4-flash-free (opencode-zen), Gemini: gemini-2.5-flash (Google OAuth) |
| **Obsidian Vaults** | 4 vaults: DevOps, DeepSeek Chat, AI/ML, SEM-2 Academics (192 files) |
---
@@ -343,6 +344,11 @@ When you (an AI agent) are dropped into this directory for the first time:
- Any AI agent reading this file should have enough context to continue seamlessly
- The agent should first read this file, then `brain/*`, then `data/settings.json`
+### Session History
+- opencode: `~/.local/share/opencode/opencode.db` + `~/.local/share/opencode/log/`
+- Hermes: `~/.hermes/sessions.json`
+- Gemini: `~/.gemini/history/`
+
---
## API Endpoints (server.py FastAPI)
@@ -379,6 +385,7 @@ When you (an AI agent) are dropped into this directory for the first time:
| Date | Version | Changes |
|------|---------|---------|
| May 17, 2026 | v1.0.0 | Initial creation โ all 51 features + 10 extras |
+| May 17, 2026 | v1.1.0 | AI Chat fixes: corrected CLI syntax (hermes `chat -q`, gemini positional), switched Hermes default to OpenRouter + Owl Alpha, improved timeout/error handling, updated execute_agent fallback logic |
---
diff --git a/README.md b/README.md
index 732bb50..a42a680 100644
--- a/README.md
+++ b/README.md
@@ -1,42 +1,283 @@
-# Agentic OS
+
+
+
+
+
+
+
+
+
+
-A multi-agent orchestration platform that coordinates **opencode**, **Hermes Agent**, and **Gemini CLI** into a unified, self-improving, autonomous work operating system.
+# Agentic OS ๐ง โ Multi-Agent Orchestration Platform
-## Quick Start
+A locally-hosted operating system for AI agents 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 |
+
+---
+
+## ๐ 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
```bash
+git clone https://github.com/modimihir07/agentic-os.git
+cd agentic-os
chmod +x install.sh && ./install.sh
-```
-
-## Architecture
-
-3 agents + 7 layers + web dashboard:
-
-| Agent | Role |
-|-------|------|
-| **opencode** | Code generation, DevOps, file operations |
-| **Hermes Agent** | Memory, scheduling, channels |
-| **Gemini CLI** | Research, analysis, multi-modal |
-
-## Features
-
-- 51 features from top agentic OS implementations
-- 10 extra features (cost analytics, git versioning, backup, prompts, etc.)
-- Interactive web dashboard (FastAPI + SPA)
-- One-click skill execution
-- Scheduled workflows
-- Persistent memory across sessions
-- Self-improving skills with eval scoring
-- Multi-agent routing and handoff
-- Cost tracking with free-tier alerts
-
-## Dashboard
-
-```bash
./start.sh
-# Visit http://127.0.0.1:8080
+# Open http://127.0.0.1:8080
```
-## License
+---
-MIT
+## ๐ Prerequisites
+
+| Tool | Required? | Install |
+|------|-----------|---------|
+| Python 3.10+ | โ Required | `sudo apt install python3 python3-pip` |
+| Node.js 18+ | โ For opencode | `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 | `curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh \| bash` |
+| Gemini CLI | โ For Google AI | `npm install -g @google/gemini-cli` |
+
+> โ = Optional โ the dashboard works with any subset of installed agents.
+
+---
+
+## ๐ง Configuration
+
+### Hermes (OpenRouter)
+```bash
+# Set your OpenRouter API key
+echo 'OPENROUTER_API_KEY=sk-or-v1-your-key-here' > ~/.hermes/.env
+```
+
+### Gemini CLI (Google OAuth)
+```bash
+gemini auth login
+# Complete OAuth in browser โ tokens saved to ~/.gemini/oauth_creds.json
+```
+
+### Dashboard Settings
+Edit `data/settings.json`:
+```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 # One-command installer
+โโโ start.sh # Launch dashboard
+โโโ backup.sh / restore.sh # 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/ # 13 page modules
+โ โโโ 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
+โ
+โโโ 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
+โ
+โโโ 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 (gitignored)
+โโโ audit/ # Activity log (gitignored)
+โโโ backups/ # Snapshots (gitignored)
+```
+
+---
+
+## ๐ฎ 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.
+
+---
+
+## ๐ 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 tar.gz snapshots |
+| **Audit Trail** | Not shown | Full activity log |
+| **Standards System** | Not shown | Discover/inject conventions |
+| **Client Timeout** | Not shown | 200s AbortController |
+| **Kanban Board** | Yes | No (not needed for agent OS) |
+| **Open Source** | No (tutorial only) | **MIT License** |
+
+---
+
+## ๐งช Tested On
+
+- **OS**: Linux (Ubuntu 22.04+), macOS
+- **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.
+
+---
+
+