Skip to content

flisk-sh/flisk

unversioned · c2f6c5121ac9MIT

Run your whole app on your own computer with one command. Skills and an MCP server that let your coding agent build, start, check and fix a local stack with the Flisk CLI.

The Flisk plugin

One package that gives a coding agent Flisk: the Flisk skills (the same ones flisk project writes into a new project) and the flisk mcp server. The agent can then build, start, check and fix your app on your own computer.

Install the Flisk CLI first. The plugin starts flisk mcp from your PATH and the skills run flisk commands:

npm install -g @flisk-sh/flisk

Install it in your agent

AgentInstall
Claude Code/plugin marketplace add flisk-sh/flisk, then /plugin install flisk@flisk
Codex (CLI and app)codex plugin marketplace add flisk-sh/flisk, then install Flisk from /plugins
GitHub Copilot CLIcopilot plugin marketplace add flisk-sh/flisk, then copilot plugin install flisk@flisk
Gemini CLIgemini extensions install https://github.com/flisk-sh/flisk
CursorInstall Flisk from the Cursor marketplace once it is listed. Until then, run flisk connect cursor in your project

Just the MCP server, in one click: Add to Cursor · Install in VS Code. Each link opens the editor's own prompt to add flisk mcp.

Flisk is also listed in the official MCP Registry as io.github.flisk-sh/flisk, so clients that search the registry find it. Any other MCP client (Claude Desktop, Windsurf, Zed and the rest): add the stdio server flisk mcp by hand, as the setup guide shows.

The MCP server runs in the folder your agent was started in. Start the agent in your project folder, or let it pass projectPath (the absolute path of the folder that holds .flisk/project.json) to the Flisk tools.

What is in this folder

One set of files for every agent format, all written by scripts/agent-plugin.mjs from cli/templates/agent-skills. Change those and run node scripts/agent-plugin.mjs; do not edit the copies here.

FileRead by
plugin.json, mcp.jsonThe open Agent Plugins format: Codex and ChatGPT, Cursor, GitHub Copilot CLI
.mcp.jsonClaude Code, and Codex and Copilot builds that predate the open format
.claude-plugin/plugin.jsonClaude Code
.codex-plugin/plugin.jsonCodex builds that predate the open format
.cursor-plugin/plugin.jsonCursor marketplace
skills/Every agent above
GEMINI.mdGemini CLI (hand-written; the extension manifest is gemini-extension.json at the repository root)

The marketplaces that list this plugin are .claude-plugin/marketplace.json (Claude Code, Copilot CLI), .agents/plugins/marketplace.json (Codex) and .cursor-plugin/marketplace.json (Cursor) at the repository root.

For the ChatGPT and Codex plugin directory, node scripts/agent-plugin.mjs --openai-zip flisk.zip writes the skills-only, desktop-only package to upload at platform.openai.com/plugins. The directory takes local MCP servers only from partners OpenAI has approved, so this package has the skills without flisk mcp.