Open source · local-first · v0.10.3

Software lifecycle management
for AI-assisted development.

Romyq turns software ideas into structured lifecycles with phases, governance, readiness tracking, and project memory. Runs locally. No cloud. No telemetry.

Get Started Documentation

terminal

$ brew install webrowse/street/romyq

Successfully installed romyq 0.10.3

$ romyq init

→ Wizard launched. Follow the prompts.

Version: v0.10.3
Tests: 1,555+
License: MIT
Cloud dependency: None
Telemetry: None
Runs: Locally

What is Romyq?

Romyq is a terminal-based software lifecycle management system. It coordinates between a planning provider and an execution provider to move a software project from idea to working code — structured by phases, governed by rules, and tracked by readiness. All state lives locally in .romyq/ within your project directory.

Mission: The definition of what a project should accomplish. Every phase and task is evaluated against the mission.
Lifecycle: Eight ordered stages from intent to verified completion. Projects advance through stages in sequence.
Governance: Rules defined in a project constitution, enforced before execution. Violations trigger replanning.
Memory: Persistent state in .romyq/: task history, knowledge base, execution memory, rules, decisions, capabilities, and lifecycle data. Human-readable JSON.
Readiness: A continuous score derived from phase completion, capability coverage, done criteria, and governance state.
Recommendations: After each task Romyq emits Continue, Pause, Review, or Stop based on current project state. The operator decides.

How Romyq differs from AI coding assistants

AI coding assistants are task-oriented and stateless. Romyq is project-oriented and stateful. It tracks what phase the project is in, what rules apply, what capabilities are missing, and whether the project is actually ready to ship.

Dimension	AI coding assistant	Romyq
Scope	Individual task	Full project lifecycle
State	Stateless	Stateful across sessions
Tracking	Nothing persisted	Phases, capabilities, readiness
Governance	None	Constitution-based rule enforcement
Memory	Context window only	Persistent state in .romyq/ across sessions
Stopping signal	None	Continue / Pause / Review / Stop
Execution model	Generates code directly	Coordinates planning + execution providers
Cloud	Usually required	None — runs locally
Telemetry	Often included	None

What exists today

v0.10.3

These features are implemented and available in the current release.

Lifecycle generation
8-stage lifecycle from mission definition to verified completion.
Complexity profiles
Basic (3 phases), Intermediate (5 phases), Advanced (7 phases).
Project memory
Repository, execution history, knowledge, and constitution layers.
Governance rules
Constitution enforcement. Violations trigger replanning, not failures.
Readiness scoring
Weighted aggregate of phase completion, capabilities, and done criteria.
Recommendation engine
Continue, Pause, Review, or Stop emitted after every task.
Timeline
Chronological log of every phase transition, task, and operator command.
Operator shell
Built-in commands: status, roadmap, phase, readiness, recommendation, pause, resume, stop, rules, knowledge, dashboard. Free-text sends a steering instruction.
Provider transparency
Configurable planning and execution providers. Swap without data migration.

What's coming

Items are marked clearly as planned or potential. See the full roadmap →

Planned

v0.11

Not yet implemented

□Bounded improvement cycles — multiple passes on complex tasks
□Structured lifecycle reviews between phases
□Enhanced visibility tooling and dashboard output
□Improved multi-provider coordination

Potential

research

Under consideration, not committed

◇Desktop UI (under consideration, no timeline)
◇Team workflows (not in active development)
◇Cloud-optional mode (not planned in the near term)

Install Romyq

No cloud account, no signup, no telemetry.