Documentation

How to install igris, write a plan and run it. These pages describe igris 1.x; SPEC.md is the normative text.

• InstallGo, Homebrew or a signed binary; what you need first.
• Quick startFrom a new project to a finished phase.
• Plan formatPhases, task tables, every column and what igris writes.
• ConfigurationEvery igris.toml key with its type and default.
• ModesThe permission modes, and which one a task gets.
• NotificationsToasts, ntfy, Discord, Slack, Gotify and a signed webhook.
• Usage and plansApprove plans in igris, token usage, the rank audit and quota.
• Split plansSpread a long plan over several files with includes.
• Plan templatesStart a project from go-cli, web-app or library.
• Draft a planHave Claude write a plan from a goal, a spec or an issue export.
• Detach and attachLeave a run going, and open it again from any terminal.
• Parallel phasesRun independent tasks at once, each in its own worktree, and what it costs.
• Control from your phoneFollow a run and answer its questions from a browser or an ntfy button, over Tailscale or ssh -L.
• Side sessionsA Claude Code session of your own next to a run.
• Adapt a planConvert a plan in another format, and review it first.
• Several projectsRunning igris in more than one project at once.
• FAQSubscription or API, models, skip-permissions, Windows.
• TroubleshootingWhat the symptoms mean and what to do.
• UpgradeFrom any 0.x release to 1.0, then 1.1, 1.2, 1.4, 1.5, 1.6 and 1.7.
• Design languageThe seven rules, the glyphs and status words, and what red means.
• CompatibilityWhat 1.x promises not to break, and the tests behind it.