Quint Code

Engineering decisions that know when they're stale.

Frame problems. Compare options fairly. Record decisions as contracts. Know when to revisit.

Supports: Claude Code, Cursor, Gemini CLI, Codex CLI, Codex App, Air

Install

curl -fsSL https://raw.githubusercontent.com/m0n0x41d/quint-code/main/install.sh | bash

Then in your project, run init with your tool's flag:

# Claude Code (default if no flag)
quint-code init

# Cursor
quint-code init --cursor

# Gemini CLI
quint-code init --gemini

# Codex CLI / Codex App
quint-code init --codex

# JetBrains Air
quint-code init --air

# All tools at once
quint-code init --all

What init does per tool

The binary is the same — only the MCP config location differs:

Important for Cursor: After init, open Cursor Settings → MCP → find quint-code → enable the toggle. Cursor adds MCP servers as disabled by default.

Note: Cursor also picks up Claude Code commands from ~/.claude/commands/ — so slash commands work even without --cursor. But MCP config (.cursor/mcp.json) must be set up for the tools to connect.

Existing project? Run /q-onboard after init — the agent scans your codebase for existing decisions worth capturing.

First time? Ask the agent to explain how it works:

/q-reason explain how to work with quint-code effectively — what commands exist, when to use each one, and what's the recommended workflow

The agent has full knowledge of all Quint tools and will walk you through them in context of your project.

How It Works

One command: /q-reason

Describe your problem. The agent frames it, generates alternatives, compares them fairly, and records the decision — all in one command. It auto-selects the right depth.

Or drive each step manually

/q-frame  → /q-char  → /q-explore → /q-compare → /q-decide
  what's      what       genuinely     fair         engineering
  broken?     matters?   different     comparison   contract
                         options

Micro-decisions on the fly

The agent captures decisions automatically when it notices them in conversation. No rationale — no record. Conflicts with active decisions are flagged. Auto-expires in 90 days.

When decisions go stale

/q-status shows what's expired and what needs attention. /q-refresh manages the lifecycle of ALL artifact types — waive, reopen, supersede, or deprecate.

What Makes It Different