VibeOS
Personal agent OS — an independent fork of VibeOS with its own branding, data home (~/.vibeos), desktop app, and CLI. Same agent core: skills, memory, gateway, cron, delegation — wired for VibeOS.
Start with plain language on the product site: What is VibeOS? · Capabilities · Product tour. This handbook is the technical reference.
Install
macOS desktop (recommended)
Grab the latest VibeOS.app / DMG from vibeos.com.ru/download. Data lives in ~/.vibeos.
From source (CLI + desktop)
git clone https://github.com/Linx72/VibeOS.git
cd VibeOS
./scripts/bootstrap-vibeos.sh
./scripts/vibeos doctor
./scripts/dev-desktop.sh # optional Electron UI
See Installation and the repo README for packing a production .app.
After install, run vibeos setup (or vibeos setup if your PATH still uses that alias), connect a provider, then start a chat in CLI or desktop.
What is VibeOS?
Not just a coding sidebar. It's an autonomous personal agent that runs in CLI, desktop, and messaging platforms — with memory, skills, cron, kanban, and subagents. VibeOS keeps the VibeOS-compatible engine while owning product identity, ~/.vibeos, and desktop packaging.
Quick Links
| 🚀 Installation | Install on Linux, macOS, WSL2, Windows, or Android |
| 📖 Quickstart Tutorial | Your first conversation and key features to try |
| 🗺️ Learning Path | Find the right docs for your experience level |
| ⚙️ Configuration | Config file, providers, models, and options |
| 💬 Messaging Gateway | Set up Telegram, Discord, Slack, WhatsApp, Teams, or more |
| 🔧 Tools & Toolsets | Built-in tools and how to configure them |
| 🧠 Memory System | Persistent memory that grows across sessions |
| 📚 Skills System | Procedural memory the agent creates and reuses |
| 🔌 MCP Integration | Connect to MCP servers and extend safely |
| 🔎 Professional research | Research Pro: Yandex/Exa search, cited briefs, vibeos research |
| 🗓️ Research daily briefing | Cron / slash recipe for scheduled cited research digests |
| 🎙️ Voice Mode | Real-time voice in CLI and messaging |
| 🎭 Personality & SOUL.md | Define the default voice with a global SOUL.md |
| 🔒 Security | Command approval, authorization, container isolation |
| 🏗️ Architecture | How it works under the hood |
| ❓ FAQ & Troubleshooting | Common questions and solutions |
Key Features
- Closed learning loop — memory, skills, FTS5 recall, optional memory providers
- Runs anywhere — local, Docker, SSH, and cloud terminal backends
- Lives where you do — CLI, desktop app, and 20+ messaging platforms via one gateway
- Scheduled automations — built-in cron with delivery to any platform
- Delegates & parallelizes — subagents and batch workstreams
- Open standard skills — compatible with agentskills.io
- MCP support — connect external tool servers
- Research Pro — cited multi-source research (
vibeos research, Yandex Search, skills + MCP) - Own home directory —
~/.vibeosby default, with migration from legacy VibeOS installs
For LLMs and coding agents
Machine-readable entry points:
/llms.txt— curated index of every doc page/llms-full.txt— full docs concatenated for one-shot ingestion
Both also resolve at /docs/llms.txt and /docs/llms-full.txt.