0perator

中文文档
0.3.0发布于 2025/12/19ES Module

Build full-stack applications instantly through natural conversation

原始使用文档
文档目录11 节
  1. Overview
  2. Example Queries
  3. Installation
  4. Init Options
  5. The Stack
  6. How it Works
  7. Development
  8. Testing
  9. Design Philosophy
  10. Success Metrics
  11. Future

0perator

Build full-stack applications with AI: real code you own and ship.

Overview

0perator helps you build modern, well-designed full-stack apps without worrying about the tech stack. You focus on product functionality and design—we handle the infrastructure.

Unlike vibe-coding platforms, you own the code: it lives in your local repo with professional workflows like git, branches, and PR reviews. You get full-stack apps with real databases and auth, not just UI prototypes. No vendor lock-in: change providers, add any library, extend beyond what we support.

Unlike plain AI coding, you don't have to research the best modern stack or how to wire it together. 0perator gives AI assistants deep, specific guidance on exact patterns—how to structure tRPC routers, which Drizzle patterns to use, how auth integrates with the database. The result is idiomatic, high-quality code with less manual steps.

We don't just build your app scaffold, we support the full development lifecycle:

  • Hardening - Intgration tests and strict type checks that catch AI mistakes early
  • Deploying - Ship to production with popular providers like Vercel
  • Iterating - Plan and build new features with AI guidance (coming soon)
  • Maintaining - Keep code health high as your app grows (coming soon)

Example Queries

After installing 0perator, try asking your AI coding assistant:

  • "Create a collaborative TODO app with user accounts"
  • "Build a real-time chat application"
  • "Create a dashboard to track my fitness goals"
  • "Build a blog with markdown support and comments"
  • "Create an expense tracker with categories and charts"

Once your app is built, we also support deployment:

  • "Deploy my app to Vercel"

And hardening for better AI-assisted development:

  • "Add backend testing"
  • "Add stricter TypeScript checks"

Finally, we support you all the way to production:

  • "Make this application production ready" (coming soon)

Installation

npx 0perator@latest init

This will configure your IDE with the MCP servers. Select which IDE to configure when prompted.

Init Options

# Interactive mode (select IDE with arrow keys)
npx 0perator@latest init

# Configure specific IDE
npx 0perator@latest init --client claude-code
npx 0perator@latest init --client cursor

# Pin to current version instead of always using latest
npx 0perator init --no-latest

The init command will:

  1. Install tiger-cli if needed
  2. Authenticate with Tiger Cloud (opens browser)
  3. Configure MCP servers for your selected IDE(s)

The Stack

0perator creates apps using the T3 Stack:

  • Next.js with App Router
  • tRPC for end-to-end type-safe APIs
  • Drizzle ORM for type-safe database queries
  • Better Auth for authentication (optional)
  • Tailwind CSS with shadcn/ui components
  • Tiger Cloud PostgreSQL with TimescaleDB

Everything is configured and connected automatically.

How it Works

0perator provides AI assistants with tools and skills via MCP (Model Context Protocol).

Because we're opinionated about the stack, we can write skills with precise, battle-tested instructions—not generic advice that works across many frameworks. This is why being opinionated matters: it lets us teach AI exactly how to build with this stack.

Skills are step-by-step guides for complex workflows. AI accesses them via the view_skill tool:

  • create-app - Full app creation: database, auth, shadcn components
  • deploy-app - Deploy to Vercel with environment configuration
  • add-backend-testing - Vitest integration tests with isolated test database
  • add-strict-checks - Stricter TypeScript and linting

Tools handle atomic operations that skills orchestrate. Examples:

  • view_skill - Load a skill to guide the current workflow
  • open_app - Open app in browser
  • create_database - Provision Tiger Cloud PostgreSQL
  • create_web_app - Scaffold T3 Stack app with database connection

Development

Dev mode: Run npm run dev -- init --dev from the repo to configure IDEs to run the MCP server from source. Code changes take effect on IDE restart without rebuilding.

See CLAUDE.md for development setup, adding new tools, and debugging.

Testing

When testing app creation, verify that the AI coding agent calls view_skill('create-app') in the first few tool calls. This ensures the agent follows the structured workflow for setting up the database, auth, and UI components correctly.

Design Philosophy

You own the code: No platform lock-in. Your code lives in your repo, runs on your infrastructure, and you can change anything—even replace us entirely.

Humans design product not infrastructure: You think about the product experience, AI handles the infrastructure decisions.

Agentic Ergonomics: Abstraction layers that help humans can hinder AI agents. 0perator embraces direct, parameter-driven interfaces that AI can use efficiently.

Best Practices Built-in: T3 Stack provides type-safety from database to UI with tRPC and Drizzle.

Success Metrics

  • Quality without the effort: Production-ready code with TypeScript, error handling, best practices
  • Completeness: Auth includes UI, database includes schema, everything works
  • Minimal Config: No manual steps, no .env editing, no npm install

Future

  • More UI themes
  • Payment integration
  • Real-time features

版本与发布记录

0perator 共发布 4 个版本,首次发布于 2025/12/08;过去 12 个月发布了 4 个版本。

版本发布日期距今
0.3.0latest2025/12/1910 个月前
0.2.02025/12/1010 个月前
0.1.12025/12/0910 个月前
0.1.02025/12/0810 个月前

关于 0perator 的常见问题

0perator 是什么?

通过自然对话立即构建全栈应用程序

如何安装 0perator?

在项目目录运行 npm install 0perator,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 0perator,可以用 npx 0perator 直接运行。

0perator 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/0perator 是否存在。

0perator 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

0perator 可以商用吗?

0perator 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

0perator 还在维护吗?

最新版本 0.3.0 发布于 2025/12/19(10 个月前);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2025/12/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。