Skip to main content

Requivo

PyPI Python License: MIT CI

Find what could change the solution before you commit to the scope.

Paste a client or stakeholder request. Requivo identifies the assumptions and missing decisions that could change the workflow, integrations, permissions, timeline or effort — then produces one brief you can review before estimating.

The shared understanding is the source of truth. Every document is generated from it.

Built for Product Managers, Solutions Engineers and Business Analysts working on complex, configurable B2B products.


Start here — Requivo Web

A local browser workspace, and the way to use Requivo. Paste a request, answer the few questions that could change the solution, see what each answer moved, generate one decision brief.

uvx --from "requivo[web,anthropic]" requivo web    # opens http://127.0.0.1:8765

One command, nothing installed — uv fetches Requivo into a temporary environment and runs it (curl -LsSf https://astral.sh/uv/install.sh | sh if you don't have uv). To keep it around, uv tool install "requivo[web,anthropic]" and then just requivo web; pipx install works the same way. Prefer plain pip? docs/getting-started.md has the virtualenv route — avoid pip install --user, which succeeds while leaving requivo off your PATH.

Set ANTHROPIC_API_KEY in your environment or a .env file to analyse and generate. Without it the interface still opens and reads existing sessions, and tells you what is missing.

Sessions stay on your machine, the server binds to localhost, and nothing leaves your workspace — no accounts, no database, no remote storage. See docs/web.md.

Two other ways in, on the same local sessions — nothing is locked to the interface you start in:

  • Claude Code — an integration. /plugin marketplace add jbkkz/requivo, then /requivo:discover <request>. Reasoning goes through your own Claude session, so there is no extra API key.
  • CLI — infrastructure. requivo discover | status | brief …, for automation and anything you drive from a script or a pipeline.

Install and first run in depth: docs/getting-started.md.


Why Requivo

An LLM will happily turn a half-understood request into a polished PRD. Clean documentation is not the same as a correct understanding — and the expensive mistakes come from the question nobody thought to ask, the one that turns a "small feature" into a three-month build.

Requivo asks a question only when the answer would materially change the solution. The rest, it infers and marks as an assumption to confirm. You spend discovery time where it moves the needle.

And because it keeps the understanding rather than just the answer, it can tell you what a changed answer costs:

You change one answer:
  "The migration is one-time. After cutover, the legacy system is read-only."

Requivo:
  What changed        Integrations & notifications
  Needs review        the two-way sync decision · the reconciliation risk · the decision brief

That is the part a chat transcript cannot do.

The canonical example is examples/leave-approval/ — one line of request, taken through the questions, the brief, and a changed answer that moves the scope. A harder, messy multi-feature one lives in examples/event-checkin-reconciliation/, and is what requivo demo replays.


How it works

  1. Bring a request — a sentence or a rambling email; a symptom, not a spec.
  2. Clarify high-impact unknowns — Requivo asks only what would change the solution, and infers the rest as assumptions to confirm.
  3. Build and validate the understanding — a versioned, typed model that is the durable product.
  4. Generate traceable documents — each is a view of the model, and knows which decisions it rests on.

The decision rule is information value = uncertainty × impact. Impact is estimated from the product context you give it, so better context means sharper questions.

The main output is a decision brief — the smallest document a scope review can be run from: what is confirmed, what is assumed, the decisions on record, the premises worth contesting, and what is still open. It is not a PRD; it is what you read before writing one. A PRD, user stories, acceptance criteria, an uncertainty-aware estimate, a delivery epic with GitHub/GitLab issue plans and release notes all generate from the same understanding, without redoing the discovery.

The vocabulary — what we know, what we are assuming, open question, needs updating, are we ready — and the model underneath it: docs/requirements-model.md.


Architecture

       Web          Claude Code        CLI / API
   (the product)   (an integration)  (infrastructure)
         \               |                /
                    Requivo Core
            validated, versioned understanding

Every interface uses the same session format and the same validated apply path — there is no fork, and no interface holds business logic of its own. The three differ in weight, not in what they can reach. The Core is provider-independent: no LLM, no network. More: docs/architecture.md.


Data and privacy

Local by default. Sessions live in .requivo/sessions/ in your workspace. No telemetry, no analytics — Requivo never phones home. When a provider is used, each turn sends your request, answers, prompts, schema and loaded context cards to the Anthropic API, and to no other server; in Claude Code mode, reasoning goes through your own Claude session. Treat anything you type as content sent to a model provider. Full notes: SECURITY.md.


Documentation

Doc What it covers
Getting started Install and first run for each interface
Web The primary interface — the local browser workspace
CLI reference Every command and flag
Requirements model The vocabulary, readiness, dependencies
Architecture Core, services, surfaces

Everything else — session format, providers, context cards, evaluations, product validation, roadmap, open-source strategy — is indexed in docs/.


Status

Actively developed, pre-1.0. The Core, CLI, Claude Code plugin and local Web interface are usable today. The session format is a published contract — versioned, forward-compatible, and shared by every interface; what is guaranteed and what is deprecated is written down in compatibility. Output is non-deterministic — treat the assessment as a senior colleague's read, not an oracle, and get expert review for any legal/tax/compliance flag it raises. See the roadmap.


Contributing and license

Contributions are welcome — see CONTRIBUTING.md. The Core, CLI and Claude Code integration are open source under MIT. The Requivo name and identity are separate from the code license — see TRADEMARKS.md.

MIT © jbkkz

Requivo was previously named Product Copilot.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

requivo-0.10.0.tar.gz (282.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

requivo-0.10.0-py3-none-any.whl (230.2 kB view details)

Uploaded Python 3

File details

Details for the file requivo-0.10.0.tar.gz.

File metadata

  • Download URL: requivo-0.10.0.tar.gz
  • Upload date:
  • Size: 282.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for requivo-0.10.0.tar.gz
Algorithm Hash digest
SHA256 3d4b4c3d8eb422bd1fddc0aac2914f156aa59063af93ff8be41b54bd98e9f5cc
MD5 2f67fac27bdbd969144c757c62713a6b
BLAKE2b-256 e1ebe68a611ffb73f71d2f6b4222ca774e515bfb6dc14c1ed0a7ab81335b0511

See more details on using hashes here.

Provenance

The following attestation bundles were made for requivo-0.10.0.tar.gz:

Publisher: publish.yml on jbkkz/requivo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file requivo-0.10.0-py3-none-any.whl.

File metadata

  • Download URL: requivo-0.10.0-py3-none-any.whl
  • Upload date:
  • Size: 230.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for requivo-0.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ce152ceb20fed83c4c279399f3701c92bae906aafcf178e7f0e7e2e6be7f6c68
MD5 6935b6fd2f800740a5c6a5f7c931bbda
BLAKE2b-256 9636e7c8dfff0131b9e9db0aefb91db63f489086f01d512cce868b28ad9f18a2

See more details on using hashes here.

Provenance

The following attestation bundles were made for requivo-0.10.0-py3-none-any.whl:

Publisher: publish.yml on jbkkz/requivo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

3.3.0

2 files

3.2.0

2 files

3.1.0

2 files

3.0.0

2 files

2.0.0

2 files

1.3.0

2 files

1.2.0

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

0.11.0

2 files

This release

0.10.0 This release

2 files

0.9.10

2 files

0.9.8

2 files

0.9.5

2 files

0.9.3

2 files

0.9.0

2 files

0.8.0

2 files

0.7.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page