Skip to main content
ClaudeWave
EN, English
simstudioai / Subagents

sim

Sim is the collaborative workspace to build, deploy, and monitor AI agents and workflows. Used by 100,000+ builders.

  • 29.9k stars
  • 3.9k forks
  • 347 open issues
  • Language: TypeScript
  • License: Apache-2.0
  • updated

Install

Terminal
git clone https://github.com/simstudioai/sim && cp sim/*.md ~/.claude/agents/
  1. Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
  2. Start a new Claude Code session to load the agents.
  3. Delegate work to them with the Task/Agent tool or by name.

Editor's note

Sim is an open-source, self-hostable AI agent workspace built with Next.js and TypeScript that lets teams design, run, and manage multi-step agent workflows through three distinct interfaces: a natural-language chat called Mothership, a visual block-based canvas called Workflows, and a code editor. It connects to over 1,000 integrations and supports every major LLM provider, including Claude via the Anthropic API, alongside OpenAI, Gemini, and DeepSeek. Agents can be grounded in uploaded documents through a built-in knowledge base, and structured data can be stored and queried using a native Tables feature with typed columns. A Copilot assistant can generate workflow blocks, wire variables, and debug errors from plain-language instructions. The platform is available as a cloud service at sim.ai or self-hosted via Docker Compose, with the latter requiring at least 12 GB of RAM. Teams automating multi-agent pipelines who need a single workspace to combine RAG, structured data, and LLM routing will find the most use here.

Installable items

24 items in this repository

Create or update a Sim integration block with correct subBlocks, conditions, dependsOn, modes, canonicalParamId usage, outputs, and tool wiring. Use when working on `apps/sim/blocks/blocks/{service}.ts` or aligning a block with its tools.

Install

Gate a block's visibility — ship an unreleased block as a preview (hidden until revealed via AppConfig/env), reveal it to admins/orgs, GA it, or kill-switch a shipped block

Install

Add a new table column type to Sim — registry entry, icon, storage shape, coercion, and the behavioral hooks the grid and API read. Use when adding a value kind under `apps/sim/lib/table/column-types/`.

Install

Add or update a Sim knowledge base connector for syncing documents from an external source, including auth mode, config fields, pagination, document mapping, tags, and registry wiring. Use when working in `apps/sim/connectors/{service}/` or adding a new external document source.

Install

Add a code-defined table enrichment (registry entry) under `apps/sim/enrichments/` backed by an ordered provider cascade, ensuring every provider tool it calls has hosted-key support. Use when adding a per-row table enrichment that fills cells via existing Sim tools.

Install

Add a runtime feature flag (AppConfig-backed on prod, secret fallback off-prod), global by default or optionally gated by workspace id, org id, user id, or platform admin

Install

Add hosted API key support to a tool so Sim provides the key (metered and billed to the workspace) when a user has not brought their own. Use when adding a `hosting` config to a tool under `apps/sim/tools/{service}/`.

Install

Add a complete Sim integration from API docs, covering tools, block, icon, optional triggers, registrations, resolved-secret/model-input safety, and integration conventions. Use when introducing a new service under `apps/sim/tools`, `apps/sim/blocks`, and `apps/sim/triggers`.

Install

Add or upgrade a curated, immutable managed CLI for Sim Function sandboxes, including client-safe catalog metadata, a pinned server-only installation recipe, checksum and executable verification, provider compatibility, PATH propagation, content-addressed image identity, and tests. Use when adding a CLI to the Sandbox managed-CLI selector or changing an existing managed CLI version or recipe.

Install

Add a new LLM model to apps/sim/providers/models.ts with specs verified against the provider's live API docs (no hallucination)

Install

Add a new Sim settings page, or audit existing settings pages for design-system compliance with the shared SettingsPanel layout. Use when creating a settings tab, or when asked to check/clean up settings pages so they match the design system (consistent title, header, search, spacing).

Install

Create tool configurations for a Sim integration by reading API docs

Install

Create webhook or polling triggers for a Sim integration

Install
babysitSkill

Drive a PR to a clean review (Greptile 5/5, zero open threads) — ships if needed, keeps it mergeable against staging, triggers Greptile, fixes real findings, replies to and resolves every thread, and loops until clean

Install
cleanupSkill

Run all code quality skills — effects, memo, callbacks, state, React Query, emcn design review, url-state, and comments — analyzing in parallel, then applying fixes sequentially

Install
councilSkill

Spawn parallel task agents to explore a given area of the codebase from multiple angles, then use their findings to answer the question or build a plan. Use when a task needs broad fan-out exploration across many files before acting.

Install

Author or review a Drizzle DB migration for zero-downtime safety — expand/contract phasing, backward-compatibility with the deployed app version, and writing the `-- migration-safe` acknowledgment the check:migrations lint requires. Use when adding/editing files under `packages/db/migrations/` or changing `packages/db/schema.ts`.

Install

Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right design direction, and ships interfaces that do not look templated. Real design systems when applicable, audit-first on redesigns, strict pre-flight check.

Install

Review UI code for alignment with the emcn design system — components, tokens, patterns, and conventions

Install

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

Install

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, typography, micro-interactions, enter/exit animations, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, font smoothing, tabular numbers, image outlines, box shadows.

Install

Review PRs and diffs for unbounded memory loading, concurrency explosions, oversized payload materialization, and missing pagination or byte caps. Use when reviewing cleanup jobs, background jobs, data imports/exports, file parsing, API fan-out, workflow execution payloads, large arrays/files, or any change that reads many rows, files, responses, logs, or external API pages into process memory.

Install

Create or migrate a protected Sim resource operation in the shared Principal and application-use-case architecture across internal APIs, public or versioned APIs, Copilot, and other trusted tool adapters. Use when adding a protected endpoint, tool command, or CRUD method; removing route- or tool-local authorization and business logic; consolidating resource reads or writes behind semantic operation policies; or adding another surface to an existing application operation while preserving contracts, identity, errors, rate limits, audit, analytics, and compatibility behavior. Treat v1, uploads, streams, large bodies, bulk recursion, and polymorphic tools as explicitly scoped special cases.

Install

Audit React Query usage for best practices — key factories, staleTime, mutations, and server state ownership

Install
README

Subagents overview

Full README on GitHub

A workspace to build, deploy and manage AI agents and workflows.

Quickstart

Cloud-hosted: sim.ai

Self-hosted

npx sim-setup

Desktop: macOS

macOS 12+, Apple Silicon and Intel. See the desktop docs to point it at a self-hosted deployment.

Capabilities

  • Connect 270+ integrations (5,400+ actions, 520+ triggers) and every major LLM

  • Add Slack, Notion, HubSpot, Salesforce, databases, and more

  • Build agents visually, conversationally, or with code

  • Ingest files, knowledge bases, and structured table data

  • Monitor runs, logs, schedules, and workflow activity

One workspace, every surface

Chat and workflows are just the start — tables, files, and knowledge all live in the same workspace, in the browser or on your desktop.

Tables — a database, built in Files — one store for your team and every agent Knowledge — your agents' memory Desktop — Sim on your Mac, browser and terminal included

MCP server

Connect Claude, Claude Code, Codex, or any MCP client to Sim Cloud at https://mcp.sim.ai/mcp. Your agent can manage workspaces, run and deploy workflows, and work with tables, knowledge bases, files, and logs. Sign in with OAuth or use an API key.

  • Claude Code: claude mcp add --transport http sim https://mcp.sim.ai/mcp, then open /mcp to sign in

  • Claude: add https://mcp.sim.ai/mcp as a custom connector under Customize → Connectors

  • Codex: codex mcp add sim --url https://mcp.sim.ai/mcp

See the MCP docs for other clients and for self-hosted URLs.

Self-hosting

Requirements: Node.js 20+ and Docker.

npx sim-setup is an interactive wizard that creates a small sim/ deployment directory, provisions the database, generates secrets, writes .env, connects a Chat API key, and starts the published Sim images with Docker Compose. It does not clone the repository.

When it finishes, open http://localhost:3000.

Inside a cloned Sim repository, run bun run sim-setup to unlock the source-only local development and Kubernetes modes.

Reconfigure an optional capability without rerunning the full wizard:

npx sim-setup config
npx sim-setup add email
npx sim-setup add storage
npx sim-setup add sandbox
npx sim-setup add jobs
npx sim-setup add cache
npx sim-setup add knowledge
npx sim-setup add chat
npx sim-setup add llm
npx sim-setup add integration slack

npx sim-setup config detects the effective local-dev, Docker Compose, or current-context Helm configuration and reports configured, missing, or invalid capabilities and OAuth integrations without printing credential values. This is separate from npx sim-setup status, which reports whether installed services are running and healthy.

Manage your install from its directory:

npx sim-setup start | stop | restart   # bring your install up / down / cycle
npx sim-setup update                   # pull and apply Compose images
npx sim-setup status                   # what's installed and healthy
npx sim-setup logs                     # follow logs
npx sim-setup doctor                   # diagnose configuration problems
npx sim-setup down                     # remove containers (data kept)
npx sim-setup reset                    # archive .env and wipe managed data

The setup package detects how you're running and acts accordingly. Use --dir to create or manage a deployment somewhere other than ./sim.

Sim also supports local models via Ollama and vLLM. See the self-hosting docs for details.

Chat API Keys

Chat is a Sim-managed service. npx sim-setup connects a Chat API key for you — sign in when it opens your browser and the key is stored automatically. To view, create, or revoke keys later, go to sim.ai/selfhost/settings/chat-keys.

Environment Variables

See the environment variables reference for the full list, or apps/sim/.env.example for defaults.

Tech Stack

Next.js · Bun · PostgreSQL · Drizzle · Better Auth · Tailwind — and the rest of the stack

Topics
agent-workflowagentic-workflowagentsaiaiagentsanthropicartificial-intelligenceautomationchatbotdeepseekgeminilow-codenextjsno-codeopenairagreacttypescript
Frequently asked

What people ask about sim

What is simstudioai/sim?

simstudioai/sim is subagents for the Claude AI ecosystem. Sim is the collaborative workspace to build, deploy, and monitor AI agents and workflows. Used by 100,000+ builders. It has 29.9k GitHub stars and its last recorded update is dated 2026-10-23.

How do I install sim?

You can install sim by cloning the repository (https://github.com/simstudioai/sim) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is simstudioai/sim safe to use?

Our security agent has analyzed simstudioai/sim and assigned a Trust Score of 100/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.

Who maintains simstudioai/sim?

simstudioai/sim is maintained by simstudioai. The last recorded GitHub activity is dated 2026-10-23, with 347 open issues.

Are there alternatives to sim?

Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.

Maintain this repo? Show its Trust Score in your README

The badge shows this repository's current Trust Score and verdict, and links back to this page. It follows the catalogue data: nobody can buy or edit the score it displays.

ClaudeWave Trust Score for simstudioai/sim
Markdown (README)
[![ClaudeWave Trust Score for simstudioai/sim](https://claudewave.com/api/badge/simstudioai-sim)](https://claudewave.com/en/repo/simstudioai-sim)
HTML
<a href="https://claudewave.com/en/repo/simstudioai-sim"><img src="https://claudewave.com/api/badge/simstudioai-sim" alt="ClaudeWave Trust Score for simstudioai/sim" width="320" height="64"></a>

What the badge means and how the score is computed

Alternatives

See all
Project homepage
https://www.sim.ai