Skip to main content

Requivo

PyPI Python CI License: MIT

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/.


Supported platforms

Platform Python Tested in CI
Linux 3.9 – 3.13 every version, every push
macOS 3.9 – 3.13 3.9 and 3.13
Windows 3.9 – 3.13 3.9 and 3.13

An untested platform and a supported platform look identical from outside, so this table says which is which. The ends of the version range are tested on macOS and Windows rather than every minor version, and the ends are the point: a platform's own standard library can behave differently at each one. Windows on 3.9 cannot resolve a symlink whose target is missing, where Windows on 3.13 can — which once left a path-containment guard holding on twelve of thirteen CI legs and not on the thirteenth. Differences in the language itself show on the Linux axis, which runs all five.

Requivo reads and writes UTF-8 everywhere, regardless of the machine's locale or the console's codepage. A session written on one machine reads back byte-identically on another. Where a console cannot represent a character Requivo prints, the character is escaped rather than dropped and never crashes the command — requivo doctor reports your console's encoding when there is something worth saying about it. A file you pass in (requivo discover ./brief.md) must be UTF-8; one that is not is refused by name rather than silently decoded into something that reads like prose and is wrong.


Status

Actively developed, and at 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-1.0.0.tar.gz (425.5 kB view details)

Uploaded Source

Built Distribution

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

requivo-1.0.0-py3-none-any.whl (294.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for requivo-1.0.0.tar.gz
Algorithm Hash digest
SHA256 9912eac2df8167d2647e86ad53dbd1fa4a83c360ff8da219f423bf7e2a1af2d7
MD5 5d7d2f96e8c2ccd17a092db9711322ce
BLAKE2b-256 c78803865ba968069ce3fcd05d62f703bf8d7e25acb4fe445be253f72b6b7ddb

See more details on using hashes here.

Provenance

The following attestation bundles were made for requivo-1.0.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-1.0.0-py3-none-any.whl.

File metadata

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

File hashes

Hashes for requivo-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 57f02bd11cc24154fba2ffc1666fc711f45ef0365f985992e789b4031810c721
MD5 f73aac9da0f7e64c5a82a06790f338d9
BLAKE2b-256 af1474ad7613db34cdbde92b21382c6b3bc0829d6af510fb074f21a51682f5db

See more details on using hashes here.

Provenance

The following attestation bundles were made for requivo-1.0.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

This release

1.0.0 This release

2 files

0.11.0

2 files

0.10.0

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