Inquiry
Analyze. Plan. Execute.
Available for OpenCode and GitHub Copilot. More hosts coming soon.
v0.25.1Public entry surface. For the canonical documentation map, start in the repository docs.
irm https://inquiry.ccisne.dev/install.ps1 | iex
Installs to %LOCALAPPDATA%\inquiry\, adds to PATH, and deploys Inquiry skills to your AI coding host.
curl -fsSL https://inquiry.ccisne.dev/install.sh | bash
Installs to ~/.inquiry/ and deploys Inquiry skills to your AI coding host.
Inquiry structures AI-assisted work as a finite-state system with an explicit END gate and optional EVOLUTION pass. Inquiry names the cycle-level process, APE names the orchestrating methodology, and the Finite APE Machine names the engineered system that operationalizes both. The real wager is philosophical and methodological: AI becomes trustworthy when disciplined thinking tools such as questioning, decomposition, verification, and selection are made operational.
The phases
ANALYZE
Clarify the problem. Capture requirements, assumptions, and edge cases before any code is written.
diagnosis.mdPLAN
Decompose the work. Order the steps, verify each, enumerate nothing missed.
plan.mdEXECUTE
Implement under the active plan and coding manifesto. Each change small enough to merge confidently.
code + commitsBackward transitions from PLAN or EXECUTE back to ANALYZE are allowed — re-analysis is part of the contract.
Quick start
# verify prerequisites (inquiry, git, gh, gh auth) iq doctor # see what deploying to your AI host would change — nothing is touched iq host get --plan # show it, ask for approval, then do it iq host get --apply # scaffold .inquiry/ in your repo cd your-repo && iq init
Commands
iqPrint ASCII banner + versioniq initScaffold repo-scoped Inquiry files (.inquiry/config.yaml, ignore rules, agent)iq doctorVerify prerequisitesiq host getDeploy skills to every AI host detected —--plan/--applyiq implementation startOpen a cycle: branch, cleanroom, ANALYZE —--plan/--applyiq fsm transitionExecute a deterministic FSM transitioniq fsm stateShow current FSM state as JSONiq ape promptAssemble sub-agent prompt from stateiq upgradeUpdate to the latest release —--plan/--apply
Commands that install, remove, or write into your repository refuse to act until you say which of --plan (show what would change) and --apply (show it, ask, then do it) you meant. Neither is the default.
13 commands total — see the full table on GitHub.
Hosts
Inquiry deploys host-scoped skills to the global configuration of your AI coding tool. The repo-scoped agent is scaffolded by iq init.
- OpenCode
- GitHub Copilot
- Claude Code
- Codex
- Crush
- Gemini
Adapters for Claude, Codex, Crush, and Gemini already exist — awaiting a stable agent prompt API before being wired in (ADR D20).
Go deeper
Architecture →
The canonical repository entry into the live Inquiry runtime, cycle, and operational model.
Meet the agents →
Five active agents — DEWEY, SOCRATES, DESCARTES, ADA, DARWIN — and the honest story of the larger roster that collapsed.
Methodology →
The FSM, the transition contract, memory-as-code, and the semantic risk matrix.
Finite APE Machine spec →
The current technical overview of the finite-state system and its supporting specifications.