Tooling

This section owns the installed Incan experience: projects, commands, editor support, diagnostics, build evidence, and CI.

Choose a route

First contactInstall and run IncanUse the canonical installer and complete the new, run, test, and release-build loop. ProjectMove beyond the starterSplit a command-line application into modules and replace placeholder tests with meaningful behavior. Preview · DeliveryPrepare a CI artifact laneVerify the local gate and report contract while hosted 0.5 toolchain installation remains a packaging preview. DiagnosisExplain a failed buildCapture stable diagnostic JSON, ask the compiler to explain it, repair the source, and inspect backend output.

Canonical first-contact flow

Getting Started is the single source for installation and the new → run → test → build loop. Audience bridge pages translate concepts but do not maintain competing setup commands.

Work by task

WriteConfigure editor feedbackSet up the LSP and keep formatting feedback close to the source. VerifyRun and filter testsUse project tests, filters, lock enforcement, and CI-friendly exit behavior. AutomateUse reproducible CI commandsApply format, check, test, lock, offline, and report contracts without scraping prose. Build systemUnderstand Oven AlphaSee how 0.5 selects receipt-compatible Loafs, executes direct-rustc plans, and accounts for storage. ReferenceLook up a command contractFind exact flags, environment variables, diagnostics, reports, and inspection schemas.

Deeper project paths

• Build and consume an Incan library
• Build a pipeline mini-project
• Manage dependencies
• Understand Oven Alpha
• Understand projects today
• Inspect compiler-backed codegraph data
• Use agent and tooling documentation surfaces

Repository make targets remain the contributor path for working on the Incan compiler itself.