Important
April 2025: Third-party tools (OpenClaw, Cline) now charge extra fees. FideliOS doesn't — and saves your tokens on top. Learn how →
███████╗██╗██████╗ ███████╗██╗ ██╗ ██████╗ ███████╗
██╔════╝██║██╔══██╗██╔════╝██║ ██║██╔═══██╗██╔════╝
█████╗ ██║██║ ██║█████╗ ██║ ██║██║ ██║███████╗
██╔══╝ ██║██║ ██║██╔══╝ ██║ ██║██║ ██║╚════██║
██║ ██║██████╔╝███████╗███████╗██║╚██████╔╝███████║
╚═╝ ╚═╝╚═════╝ ╚══════╝╚══════╝╚═╝ ╚═════╝ ╚══════╝
AI Agent Orchestration Platform
Hire AI agents. Give them goals. Run the company from your dashboard.
Quick Start · Why FideliOS · Features · Architecture · fidelios.nl
demo.mp4
As of April 2025, AI providers started charging extra fees for third-party tools like OpenClaw and Cline — every agent action now costs premium credits on top of your subscription. Many users are already seeing unexpected bills.
FideliOS is not affected. We connect through official provider tools (Claude Code, Codex, Gemini CLI), so your agents run entirely within your existing subscription. No extra charges. No restrictions. No surprises.
But we go further — FideliOS actively saves your money:
| 🛡️ No extra fees | While third-party tools now burn premium credits per action, FideliOS runs on your existing plan. You pay what you already pay — nothing more. |
| ⚡ Tokens stay in your pocket | Built-in context caching (CAG/RAG) means agents don't re-read the same data over and over. Less tokens spent = more work done for the same money. |
| 💸 Go near-zero | Add local AI models (Ollama, LM Studio) for routine tasks — same management, same quality, near-zero cost. Cloud when you need power, local when you don't. |
FideliOS is an operating system for AI-driven companies. You define the mission, hire a team of AI agents, set budgets and rules — and they figure out the work.
It's self-hosted, runs locally, and works with any agent runtime: Claude Code, Codex, Cursor, Gemini, OpenClaw — anything that can receive an HTTP heartbeat.
You set the goal → "Build the #1 AI note-taking app to $1M MRR"
You hire the team → CEO, CTO, engineers, marketers — any agent, any provider
You approve and go → Review strategy, set budgets, monitor from the dashboard
The before/after of managing AI agents:
| 🔴 Without | 🟢 With FideliOS |
|---|---|
| 20 Claude Code tabs, no idea who does what. Reboot = start over. | Ticket-based tasks, threaded conversations, sessions persist across reboots. |
| Copy-pasting context between agents manually. | Context flows from task → project → company goal automatically. |
| Reinventing task management with folders and scripts. | Org charts, ticketing, delegation, governance — out of the box. |
| Runaway token costs you discover too late. | Budgets per agent + Peak Hours Guard to block expensive time windows. |
| Recurring jobs you forget to kick off. | Heartbeat scheduler handles it. Management supervises. |
| "Let me fire up Claude Code and babysit this tab..." | Add a task. Agent works until done. Management reviews. |
| Need laptop + terminal to manage anything. | PWA on any device. Telegram bot for approvals and updates on the go. |
|
🔌 Bring Your Own Agent — Claude Code, Codex, Cursor, Gemini, OpenClaw, or any HTTP-compatible runtime. One org chart for all of them. 🎯 Goal Alignment — Every task traces back to the company mission. Agents always know what to do and why. 💓 Heartbeat Scheduler — Agents wake on schedule, check their work, act, and go back to sleep. No babysitting. 💰 Cost Control — Monthly budgets per agent. Peak Hours Guard blocks runs during expensive API windows. 🏢 Multi-Company — One deployment, many companies, complete data isolation. 🎫 Ticket System — Every conversation traced. Every decision explained. Full audit log. |
🛡️ Governance — You're the board. Approve hires, override strategy, pause or fire any agent. 📊 Org Chart — Hierarchies, roles, reporting lines — just like a real company. 📱 Mobile + Telegram — PWA works on any device. Telegram plugin for updates, approvals, and task creation. 🔌 Plugin System — Extend with Telegram, webhooks, MCP servers. First-class SDK with hot-reload in dev. 💾 Auto Backups — Compressed backups every 15 minutes. One-command restore. Optional S3 sync. 🔄 Self-Updating — Version checker notifies when a new release is available. One command to upgrade. |
| 🔒 Subscription-safe | First-party CLI integration means your agents run on your existing subscription — not on metered third-party credits. Zero extra usage fees, zero harness surcharges, zero surprises. |
| CAG (Context-Augmented Generation) | Pre-compiled context bundles so agents get full project state in one shot — no API round-trips, no hallucinated context. |
| RAG-ready architecture | Structured knowledge retrieval from issues, comments, goals, and org data — agents search, not guess. |
| Token optimization | Smart context compression, session persistence across heartbeats, and skip-detection to avoid wasting tokens on no-op runs. |
| Process security | Atomic task checkout, budget enforcement, approval gates, and full audit trails — no agent acts without authorization. |
| Atomic execution | Task checkout + budget check in one transaction. No double-work, no surprise bills. |
| Persistent state | Agents resume the same context across heartbeats — no "starting from scratch" every run. |
| Skill injection | Agents learn your workflows at runtime without retraining. |
| Goal ancestry | Every task carries the full chain: task → project → company goal. Agents see the big picture. |
| Plugin-first | Telegram, webhooks, custom tools — all through a first-class plugin SDK, not hacks. |
| Zero cloud dependency | Everything local. Your data stays on your machine. S3 backup is opt-in. |
Not a chatbot — agents have jobs, not chat windows. Not an agent framework — we don't build agents, we run companies made of them. Not a workflow builder — no drag-and-drop. FideliOS models companies with org charts, goals, and governance. Not for one agent — if you have one agent, you don't need this. If you have twenty — you do.
|
Open Terminal and paste: Installs everything automatically. |
Open Terminal and paste: Sets up Docker and runs FideliOS. |
Open PowerShell and paste: Sets up Docker and runs FideliOS. |
Already have Node.js? Just run
npm install -g fidelios && fidelios run
Open http://127.0.0.1:3100 — the wizard walks you through creating your first company and hiring your first agent. Embedded PostgreSQL starts automatically.
All commands
fidelios run # Start the server
fidelios onboard # Re-run the setup wizard
fidelios doctor # Check your environment
fidelios update # Update to the latest version
fidelios db:restore # Restore from a backup
fidelios --help # All commandsRun from source
git clone https://github.com/fideliosai/fidelios.git
cd fidelios
pnpm install
pnpm dev:watchSee doc/DEVELOPING.md for the full guide.
Automatic compressed backups every 15 minutes. Optional S3 cloud sync.
fidelios db:restore --latest # Restore latest backup
fidelios db:restore # Pick from a listS3 Cloud Sync
{
"database": {
"backup": {
"s3": {
"enabled": true,
"bucket": "your-bucket",
"region": "eu-west-1",
"prefix": "fidelios/backups/"
}
}
}
}| 📡 Tailscale Remote Access | Access FideliOS from your phone over a secure private network |
| 💬 Telegram Gateway | Agent updates, approvals, two-way messaging via Telegram |
| 🛠 Developing | Full development guide for contributors |
| 📖 CLI Reference | All CLI commands and options |
fidelios/
├── cli/ # fidelios CLI — onboard, run, doctor, restore
├── server/ # Express API + Vite UI + embedded PostgreSQL
├── ui/ # React + Vite frontend
├── packages/
│ ├── db/ # Drizzle ORM, migrations, backup/restore
│ ├── shared/ # Types, config schema
│ ├── adapter-utils/ # Shared adapter base
│ ├── adapters/ # claude, codex, cursor, gemini, openclaw…
│ └── plugins/ # Plugin SDK + examples
└── scripts/ # Release, backup, dev tooling
Stack: Node.js · TypeScript · Express · React · Vite · Drizzle ORM · embedded PostgreSQL
MIT — see LICENSE.
Open source. Self-hosted. Built for people who want to run companies, not babysit agents.