TheoWorks
Git-native docs, requirements & tests

User-friendly, traceable docs,
straight from your Git repo.

TheoWorks is a friendly, browser-based workspace for sphinx-needs projects — documentation, requirements and tests together. Everyone on the team can write, link and trace, while every edit round-trips to clean, human-diffable RST in Git. Cloud, or self-host.

Free for individuals and teams up to 5 · No credit card required
Built for regulated, safety-critical engineering
On-premiseSSOGit-nativeHuman-diffable RSTFull audit trailAir-gapped install (Enterprise)Coming soon
Product

Everything a team needs for traceable docs

Documentation, requirements and tests in one friendly editor — with traceability and validation, all versioned in Git. Agents that automate the busywork are on the roadmap.

A document editor, not a form

Write like you would in Google Docs. Headings, prose, tables, callouts and typed requirements coexist in one clean document — with math and formulas, and a live preview as you type.

The TheoWorks editor showing a system requirements document, with rendered requirement blocks including status, ASIL rating and traceability links

Typed, traceable needs

System, software and test items — linked, validated and versioned.

SYSSWTEST

Git is the database

We never own your data. Every edit is a clean, human-diffable RST commit.

docs/requirements.rst
+ :status: approved
- :status: in_review
:links: SW-REQ-032

Agents that automate the busywork

Coming soon

Agents you'll run from a friendly web UI to automate reviews, trace coverage and keep compliance green — every change proposed for your approval. On the roadmap.

PROPOSED CHANGESPreview3 edits
Add TEST-118 verifying SW-REQ-032
Apply allPreview
Coming soon

MCP server

Connect TheoWorks to your agent tools over MCP — on the roadmap. Pro.

Validation & workflows

Status gates and required fields enforced per work-item type.

Filter & find

Search prose and needs with the full sphinx-needs query language. Project View takes the same query project-wide, with a needs-map graph of the results.

type == "swreq" and status == "approved"

Static viewer, no server

Publish a read-only requirements site straight from CI. Reviewers need nothing installed.

Review

Review proposed changes as the rendered document

See the rendered outcome — red/green on real needs, tables and images — not a raw RST diff. Comment inline; your comments are real GitLab merge-request discussions your team already sees in GitLab. Reply, resolve, and drop into edit mode to fix it yourself, right from the review.

  • Rendered-outcome diff — not raw RST source
  • Inline comments are real GitLab MR discussions
  • Reply and resolve threads without leaving Theoworks
  • Continue conversation on GitLab as same comments also appear in the MR
MCP SERVER
Coming soon

Let your agent tools work with your docs, safely

Connect your agent tools directly to your deliverables and traceability — agents can read needs, propose edits and check coverage. Every edit an agent proposes is validated before it lands, so an agent can never write invalid data into your project: an invalid status, a missing required field, or a dangling link is refused right at the edit, not caught later.

  • Agents read needs and traceability directly
  • Agents propose edits for your review
  • Every agent edit is validated before it lands
Deployment

Runs where your code runs

Same product, your choice of topology. Because Git is the database, your requirements never leave your control.

Cloud
Managed by TheoWorks

The fastest way to start. We host the thin git-native backend; you connect your repo and go.

Connect a repo and start in minutes
Automatic updates and managed backups
GitLab sign-in (GitHub coming soon)
Static viewer published straight from CI
On-premise
Your infrastructure

Deploy the same artifact inside your network — ideal for defence, automotive and medical, where your repo never leaves your control.

Docker Compose or a single VM, or a Kubernetes/OpenShift cluster via Helm
Full data residency — your repo, your rules
Air-gapped install for Enterprise, with an offline license file Coming soon
VS Code extension
"TheoWorks IDE" · Install from the Marketplace

Already live in VS Code? Bring typed needs and traceability into your editor — connect a TheoWorks server for live preview.

Language completion for needs, types and links
Peek and go-to definition for any need reference
Auto-ID generation straight from your local needs.json
Live preview once you connect to a TheoWorks server
Get it on the Marketplace
Templates & metamodel

Start in minutes — from a template, or your own repo

Spin up a ready-to-use project template and get going fast — ASPICE, ISO 26262 and V-model are just examples. Templates are pluggable and fully editable to match how your team already works.

Ready-to-use project templates
Scaffold work-item types, links, fields and workflows in one click — then tweak anything.
Bring your own repo
Migrate an existing project and TheoWorks learns its metamodel automatically — no reconfiguring from scratch.
Pricing

Free to start. Fair as you scale.

Commercial use included on every tier — even the free one.

Free
For individuals and small teams
$0forever
Up to 5 users · commercial use OK
Up to 5 users, commercial use included
Cloud or on-premise deployment
Full editor, git round-trip & validation
Static viewer & community support
MOST POPULAR
Pro
For growing teams that need scale
$20/ user / mo
billed monthly · cancel anytime
Everything in Free, plus
Up to 100 users
ASPICE quick-start project templates
Single Sign-On (SSO)
Premium support
ReqIF roundtrip Coming soon
Enterprise
For regulated organizations at scale
Custom
Volume & on-prem licensing
Contact sales
Everything in Pro, plus
Air-gapped deployment via offline license files Coming soon
Governance, audit & custom packs
Dedicated support & SLA
AI integration in the web-editor Coming soon
MCP server Coming soon
Enterprise

Talk to us about your rollout

On-premise deployment, SSO, custom standard packs and volume pricing — with air-gapped installs for Enterprise coming soon. Tell us about your team and we'll get back within one business day.

Response within one business day
Security review & DPA available
On-prem rollout support

Prefer email? Reach us at support@theoworks.io.

Start writing traceable docs today

Try the sample project in your browser — no install, no credit card.

Book a demo