
What you can build
MobKit’s primary pattern is layered agent architectures — but it’s not limited to any single topology:- Domain agents that own a capability (email, calendar, code review, data analysis)
- Personal agents that represent a user and delegate to domain agents
- Group agents that coordinate across a team or initiative
- Task agents that are spawned on demand for short-lived work
What MobKit provides
- Orchestration. Bootstrap an entire mob and its operational modules in a single call. Process supervision, health gates, and configurable restart policies.
- Identity-first continuity. Durable agent identities with roster providers, topology-aware prompts, non-destructive respawn, destructive reset, and in-process reconciliation. Agents survive restarts with stable session IDs.
- Roster management. List, inspect, spawn, retire, and respawn members. Ensure agents exist before sending them work. Reconcile the roster against a desired state.
- Operational subsystems. Message routing with sink adapters, risk-based approval gates, cron scheduling with timezone support, and semantic memory — all wired in as supervised modules.
- Admin console. React web UI with agent sidebar, activity feed, chat inspector, topology view, and health overview — all updating in real time via SSE.
- Session persistence. JSON file storage for development, BigQuery adapter for production. Complements Meerkat’s own runtime-backed session durability.
- Authentication. JWT/OIDC validation with JWKS discovery and email allowlists. Google, GitHub, Generic OIDC, and Service Identity providers.
- SDKs. Python and TypeScript SDKs with typed returns and contract parity tests against the Rust core.
MobKit and Meerkat
Meerkat is the engine that makes each agent work. MobKit is the toolkit that makes them work together.
Explore the documentation
Quickstart
Bootstrap a runtime with modules and a Meerkat mob in under a minute.
Core Concepts
Modules, events, gating, delivery, scheduling, memory, and sessions.
Guides
Step-by-step walkthroughs for the unified runtime, module system, and console.
Architecture
Internal architecture, crate structure, and design decisions.
APIs
JSON-RPC, REST, and SSE protocol references.
SDKs
Rust, TypeScript, and Python SDK documentation.
