bilig

Coding Agent Rule Chooser

Use this page when a coding agent is in a cloned repo and you need to know which Bilig file it should read before spreadsheet-shaped work.

Run the no-key agent MCP proof first:

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json

The result must include schemaVersion: "bilig-evaluator.v1", door: "agent-mcp", verified: true, edited cell evidence, formula readback, exported or persisted WorkPaper state, and restore or restart readback. A write call alone is not success.

Quick Choice

Agent host Use this Bilig file Tool hookup Proof bar
Codex AGENTS.md in the repo directory chain. Public handoff: docs/AGENTS.md. Optional .mcp.json when the Codex environment supports MCP. Run bilig-agent-start --json, then bilig-evaluate --door agent-mcp --json.
Claude Code CLAUDE.md, then .claude/skills/bilig-workpaper/SKILL.md or .claude/commands/bilig-workpaper-proof.md. .mcp.json defines the file-backed bilig-workpaper stdio server. Use /bilig-workpaper-proof <task> before Excel, LibreOffice, Sheets, browser grids, or screenshots.
GitHub Copilot .github/copilot-instructions.md plus .github/instructions/bilig-workpaper.instructions.md. .github/prompts/bilig-workpaper-proof.prompt.md for the task prompt, .vscode/mcp.json in VS Code. Copilot should return WorkPaper readback fields, not spreadsheet UI status.
VS Code agent mode .github/copilot-instructions.md and .github/instructions/bilig-workpaper.instructions.md. .vscode/mcp.json for biligWorkpaperDemo and biligWorkpaperFile. Use the workspace MCP config before copying a generic mcpServers manifest.
Cursor .cursor/rules/bilig-workpaper.mdc. .cursor/mcp.json for local file-backed WorkPaper tools. Treat .cursorrules as legacy; use the project rule and MCP config here.
Kiro .kiro/steering/bilig-workpaper.md; Kiro also loads root AGENTS.md when present. .kiro/settings/mcp.json defines the project-local file-backed WorkPaper MCP server. Use Kiro steering and the project MCP server before spreadsheet UI automation.
Roo Code .roo/rules/bilig-workpaper.md; Roo also loads root AGENTS.md by default. .roo/mcp.json defines the project-local file-backed WorkPaper MCP server. Use Roo’s project rule and MCP server before spreadsheet UI automation.
Trae .trae/rules/bilig-workpaper.md; Trae also loads root AGENTS.md when present. .trae/mcp.json defines the project-local file-backed WorkPaper MCP server after Project MCP is enabled. Use Trae’s project rule and MCP server before spreadsheet UI automation.
Qodo IDE AGENTS.md plus the Qodo WorkPaper MCP setup. Paste the bilig-workpaper JSON into Qodo Agentic Tools MCP settings. Use Qodo’s local MCP tool before spreadsheet UI automation; do not claim a repo-native .qodo config file.
Zed .zed/settings.json, root AGENTS.md, and .agents/skills/bilig-workpaper/SKILL.md. .zed/settings.json defines the project-local context_servers.bilig-workpaper MCP server. Use Zed’s context server before spreadsheet UI automation and keep tool permissions scoped to WorkPaper readback.
JetBrains Junie AGENTS.md in the repo root; .junie/AGENTS.md can add narrower project memory when needed. .junie/mcp/mcp.json defines the file-backed WorkPaper MCP server. Use Junie MCP tools for workbook readback and require persisted WorkPaper evidence before reporting success.
OpenHands AGENTS.md, then .agents/skills/bilig-workpaper/SKILL.md. openhands mcp add bilig-workpaper --transport stdio npm -- exec --yes --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./.bilig/pricing.workpaper.json --init-demo-workpaper --writable. Use /mcp in the conversation and restart after MCP config changes.
OpenCode opencode.jsonc, then .opencode/agents/bilig-workpaper.md. opencode.jsonc defines the local bilig-workpaper MCP server and a disabled hosted demo server. Invoke the @bilig-workpaper subagent for workbook-shaped tasks and require readback fields.
Aider CONVENTIONS.md, loaded by .aider.conf.yml. Run the local bilig-workpaper-mcp command from the conventions when state must persist. Keep Aider’s answer tied to WorkPaper readback, export or restore evidence, and explicit limitations.
Goose examples/goose-workpaper-mcp/recipe.yaml. The recipe launches the local file-backed WorkPaper MCP server; use hosted Streamable HTTP only for stateless smoke. Validate the recipe, run bilig-evaluate --door agent-mcp --json, and require set_cell_contents_and_readback, Summary!B3 60000 -> 96000, export, restore, and verified: true.
Windsurf/Cascade .devin/rules/bilig-workpaper.md, with .windsurf/rules/bilig-workpaper.md kept as a fallback. Start with the same bilig-evaluate --door agent-mcp --json command, then file-backed MCP if state must persist. The rule uses trigger: model_decision; require computed readback before reporting success.
Cline .clinerules/bilig-workpaper.md. Add MCP through Cline’s current MCP settings when direct tool calls are needed. Cline should use the workspace rule when workbook formulas, cells, or MCP spreadsheet tools appear.
Continue .continue/rules/bilig-workpaper.md. .continue/mcpServers/bilig-workpaper.yaml defines the project-local file-backed WorkPaper MCP server. Use the rule for Agent, Chat, and Edit requests; use the MCP block from Continue Agent mode when the task needs direct workbook tools.
Gemini CLI gemini-extension.json plus gemini-workpaper-context.md; generated starters also include GEMINI.md. gemini extensions install https://github.com/proompteng/bilig --ref main. The extension starts the bilig-workpaper MCP server and injects the WorkPaper proof context.

Existing Repo Overlay

For a repo that already has app code, add only the agent and MCP files:

npm create @bilig/workpaper@latest . -- --add-agent

That overlay writes AGENTS.md, CONVENTIONS.md, .aider.conf.yml, CLAUDE.md, GEMINI.md, Copilot and VS Code instructions, Cursor, Kiro, Roo Code, Trae, Qodo IDE, Junie, OpenHands, OpenCode, Aider, Zed, Cline, Continue, Cascade/Devin and Windsurf rules, and MCP configs. It does not overwrite an existing app README.md or package.json.

For a blank agent-ready project, use:

npm create @bilig/workpaper@latest pricing-agent -- --agent

Confusion Guards

Official Host Docs Checked