Stoic AgentOS – Open-source operating system for AI agent fleets

Notifications You must be signed in to change notification settings

Fork 0

Star 0

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

15 Commits

15 Commits

api

api

public

public

sdk

sdk

src

src

supabase/.temp

supabase/.temp

.gitignore

.gitignore

Dockerfile

Dockerfile

README.md

README.md

eslint.config.js

eslint.config.js

index.html

index.html

package-lock.json

package-lock.json

package.json

package.json

vercel.json

vercel.json

vite.config.js

vite.config.js

Repository files navigation

The Operating System for AI Agent Fleets

Monitor, orchestrate, and persist knowledge across your AI agents — from a single dashboard.

Dashboard · Docs · Get Started Free · npm · Quick Start

⭐ If this helps you ship AI agents faster, give us a star — it helps a lot!

The Problem

You're running AI agents in production — coding assistants, data pipelines, customer support bots, trading bots, content generators. Each one makes autonomous decisions, but:

No visibility → Agent fails at 3 AM, you find out Monday

No memory → Same agent rediscovers the same bug every session

No coordination → 5 agents, 5 silos, zero shared knowledge

The Solution

AgentOS gives your AI fleet a command center — real-time monitoring, persistent knowledge that survives across sessions, and usage-based billing that scales with you.

Your Agent Fleet → AgentOS SDK → Dashboard ├── Coding Assistant 3 lines 📊 Real-time status ├── Data Pipeline of code 🧠 Shared knowledge ├── Support Bot 📈 Usage analytics └── Content Generator 🔑 API key management

Quick Start

1. Install

npm install stoic-agentos-sdk

1. Get Your API Key

Sign up at stoic-agentos.vercel.app → Dashboard → Settings → Generate Key

1. Monitor Your First Agent

import { AgentOS } from 'stoic-agentos-sdk';

const os = new AgentOS({ apiKey: 'sk_live_your_key_here', workspace: 'my-project', });

// Wrap any function → auto-captures start, success, and errors const myAgent = os.wrapAgent('invoice-processor', async (input) => { const result = await processInvoice(input); return result; });

// Run it — AgentOS tracks everything await myAgent({ invoiceId: 'INV-001' });

1. Capture Decisions & Knowledge

// Capture important observations os.capture({ type: 'decision', title: 'Switched to GPT-4o-mini for summarization', content: 'Reduced cost by 40% with no quality loss on BLEU benchmark', });

// Persist knowledge across sessions os.capture({ type: 'architecture', title: 'Payment service uses idempotency keys', content: 'Always include X-Idempotency-Key header to prevent double charges', });

Features

Feature Description

🤖 Agent Monitoring Real-time status, heartbeats, error tracking for your entire fleet

🧠 Knowledge Persistence Agents remember decisions across sessions — no more re-learning

📊 Usage Analytics Observations/month, agent runs, error rates at a glance

📦 Multi-Workspace Group agents by project, repo, or team

⚡ Auto-Capture wrapAgent() logs start, success, and errors automatically

🔑 API Key Management Generate, list, and revoke keys from the dashboard

💳 Usage-Based Billing Free tier with real limits, upgrade when you need more

🔒 Row-Level Security Full RLS on Supabase — your data is isolated per org

Why AgentOS?

Stoic AgentOS Langfuse AgentOps CrewAI

Agent monitoring ✅ ✅ ✅ ⚠️ Orchestration only

Knowledge persistence ✅ ❌ ❌ ❌

Auto-capture SDK ✅ 3 lines ⚠️ Decorator-based ✅ ❌

Multi-workspace ✅ ⚠️ Projects ❌ ❌

Self-serve dashboard ✅ ✅ ✅ ❌

Usage limits + billing ✅ Built-in ✅ ❌ ❌

Open-source core ✅ MIT ✅ MIT Partial ✅

Setup time 3 min 10 min 5 min 30 min

Pricing

Free Pro — $49/mo Team — $299/mo Enterprise

Workspaces 2 10 Unlimited Unlimited

Agents 5 25 100 Unlimited

Observations/mo 10,000 100,000 Unlimited Unlimited

Knowledge items 5 25 Unlimited Unlimited

Members 1 5 15 Unlimited

Start Free →

Architecture

┌────────────────────────────────┐ │ Your Application │ │ ├── Agent 1 │ │ ├── Agent 2 │─── stoic-agentos-sdk (npm) │ └── Agent N │ │ └────────────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────────┐ │ AgentOS API (Railway) │ │ ├── Auth (Supabase JWT + API Keys) │ │ ├── Observations → /api/v1/observations │ │ ├── Agents → /api/v1/agents │ │ ├── Knowledge → /api/v1/knowledge-items │ │ ├── Billing → /api/v1/billing (Stripe) │ │ └── Webhooks → /webhooks/stripe, /webhooks/git │ └──────────────────────────────────────────────────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────────┐ │ Supabase │ │ Stripe │ │ (Postgres) │ │ (Billing) │ │ 8 tables │ │ Checkout + │ │ RLS on all │ │ Portal + │ │ │ │ Webhooks │ └─────────────┘ └─────────────────┘

API Reference

Method Endpoint Auth Description

POST /api/v1/observations API Key Create observation

GET /api/v1/observations API Key List observations

POST /api/v1/agents API Key Register agent

GET /api/v1/agents API Key List agents

POST /api/v1/agents/heartbeat API Key Agent heartbeat (upsert)

POST /api/v1/knowledge-items API Key Create knowledge item

POST /api/v1/workspaces API Key Create workspace

GET /api/v1/stats API Key Dashboard stats

POST /api/v1/api-keys JWT Generate API key

DELETE /api/v1/api-keys/:id JWT Revoke API key

POST /api/v1/billing/checkout JWT Start Stripe checkout

POST /api/v1/billing/portal JWT Open customer portal

SDK Reference

import { AgentOS } from 'stoic-agentos-sdk';

// Initialize const os = new AgentOS({ apiKey: 'sk_live_xxx', workspace: 'my-app' });

// Core methods os.capture({ type, title, content, metadata }) // Log observation os.wrapAgent(name, fn) // Auto-monitor function os.addKnowledge({ name, summary, content }) // Persist knowledge os.listAgents() // Get all agents os.listObservations({ limit, type }) // Query observations

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Clone the repo

git clone https://github.com/benjaminkernbaum-ux/stoic-agentos.git cd stoic-agentos

Install dependencies

npm install

Start dev server

npm run dev

License

MIT © 2026 Benjamin Kernbaum

Built with conviction.

stoic-agentos.vercel.app

About

The Operating System for AI Agent Fleets - monitor, orchestrate, and persist knowledge across your AI agents from a single dashboard.

stoic-agentos.vercel.app

Topics

nodejs

typescript

devtools

saas

observability

knowledge-management

ai-agents

llm

ai-ops

llm-ops

agent-monitoring

agent-orchestration

Resources

Readme

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks

Report repository

Releases

No releases published

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Contributors 1

benjaminkernbaum-ux

Languages

JavaScript 67.9%

CSS 27.2%

PLpgSQL 4.1%

Other 0.8%