⚡ Stoic AgentOS

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

2. Get Your API Key

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

3. 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' });

4. 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

Why AgentOS?

Pricing

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

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