Flisk 用一條命令在本機啟動多服務應用,並交代功能邊界
Flisk: run a multi-service app on your laptop with one command (and what it does not do)
Flisk 是開源命令列工具,可用一條命令在本機啟動多服務應用,並以每個服務的 service.json 生成相關設定,按依賴及健康檢查順序啟動。它提供 24 個 MCP 工具供 Claude Code、Codex 和 Cursor 使用;資料庫、每個服務的 gateway URL 或與部署相同的容器需要 Docker(Engine 25+)及 Tilt 0.25+。
Flisk is an open-source command-line tool that runs every part of a multi-service app (API, website, worker, database) on your own computer with one command. The README says a small app starts "as two local processes in about a second", with no Docker.
- Repo URL: https://github.com/flisk-sh/flisk
- Language: TypeScript CLI (Ink terminal UI). Runs on Node.js 22.12+. Your own services can be Node, Python, Go, Rust, JVM, Ruby or PHP.
-
Try it:
npx @flisk-sh/flisk demo. No signup, no global install. With Docker and Tilt it starts a six-service restaurant demo with Postgres, one gateway and live reload. Without them it starts a small menu app as two local processes athttp://localhost:3000, andflisk downstops it. -
CLI:
-
flisk createasks a few questions and writes a project that runs. -
flisk import .reads adocker-compose.ymland writes oneservice.jsonper Compose service, keeping ports, names and env values. -
flisk upstarts services in health-checkeddependsOnorder and prints a*.localhostURL for each. -
flisk status,flisk logsandflisk doctorshow what is running and what is wrong. -
flisk downstops everything.
-
-
Config: One small
service.jsonper service. From it Flisk writes the Dockerfile, the Compose entry, the Traefik route, the health check andDATABASE_URL. It refuses to start if a generated file was edited by hand, andflisk config verifyreports drift. -
Docker: Optional. Services that each declare a
commandrun as plain local processes. A database, one gateway URL for every service, or the same container you deploy need Docker (Engine 25+) and Tilt 0.25+. -
For AI helpers:
flisk mcpis an MCP server with 24 tools for Claude Code, Codex and Cursor.flisk connect claude(orcursor,codex) adds it. The idea is that the helper writes your app and Flisk writes the setup around it, the same way every time. -
Speed (from the repo's own benchmarks):
- A plain Compose app (a Node API and Postgres) answered through Flisk's router 49 s after
flisk importon a clean Ubuntu CI runner, images pulled and built from scratch. - With warm image layers, a one-backend stack is healthy in 12.8 to 13.8 seconds.
- An 8-service stack settles in 32 to 42 seconds warm and about 4.5 minutes on its first cold build.
- A plain Compose app (a Node API and Postgres) answered through Flisk's router 49 s after
-
Licence: MIT.
flisk upneeds no key. Premium extras are optional. -
Maturity: The npm package is at 1.4.x and the repo has thousands of commits. The README lists five teams that run
flisk upon their own code, with their consent. The timings above come from CI runs the README links, not from an independent benchmark. -
Not a deploy tool: It does not emit Kubernetes manifests and does not replace Helm, Kustomize, Flux or Argo. The one export scope is opt-in:
flisk export render,wranglerandcomposewriterender.yaml,wrangler.tomlor a standalonedocker-compose.yml. They write files only. They never deploy and never call a cloud API. -
Windows:
flisk demoand local processes work natively. The full Docker stack runs in Ubuntu on WSL2. - Not mentioned: Memory use compared with plain Compose, support for apps that need a local Kubernetes cluster, and any third-party benchmark.
When it fits, and when it does not
It fits when you run 3 to 10 services locally, you are tired of keeping a Compose file, a Tiltfile and a gateway config in sync by hand, or you want an AI helper to start and fix your stack without rewriting a Dockerfile each time.
It does not fit when your app is a single process, when your local setup already needs a real cluster, or when you want a tool that also ships to production.
Try it in 30 seconds
npx @flisk-sh/flisk demo
Already have a Compose file?
npx @flisk-sh/flisk import .
npx @flisk-sh/flisk up
Add --dry-run to import to preview first.
Repo: https://github.com/flisk-sh/flisk · Site: https://flisk.sh
來源:DEV Community · dev.to