Troven
Troven is a Git-native CLI for tracking change intents and speculative development in software projects.
It maintains both positive knowledge (accepted changes) and rejection knowledge (dead ends, discarded hypotheses, benchmark findings) in structured, conflict-free records.
The Four Verbs
| Command | Action |
|---|---|
troven create <name> [--from <base>] |
Start a new troven worktree and initialize its record. |
troven open [<id>] |
Open an active or rejected troven in a worktree. |
troven accept [<id>] [--into <branch>] |
Fast-forward merge changes into target branch, recording outcome. |
troven reject [<id>] |
Archive branch to refs/archive/troven/<id>, recording rejection verdict. |
Exploration & Visibility
| Command | Action |
|---|---|
troven list [--status <state>] |
Hierarchical DAG view of all active, accepted, and rejected trovens. |
troven show [<id>] |
Print full markdown record for a troven. |
Installation
# Editable install via pip or uv:
pip install -e .
# or
uv tool install --editable .
Record Format (.troven/<id>.md)
Every troven is backed by a conflict-free markdown file:
---
version: 1
id: 2026-08-30-fast-lexer-simd
parent: 2026-08-30-fast-lexer
forked_from: null
status: active
base_branch: master
base_commit: 8f3c1a2d
target_ref: null
created_at: "2026-08-30T14:22:00-03:00"
resolved_at: null
---
## Summary
<!-- REQUIRED before accept or reject. Agent or user fills this in. -->
---
## Details
<!-- Optional append-only log. -->
1 maintainer
Metadata
1 maintainer
Release files for troven 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| troven-0.1.0.tar.gz | 18.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| troven-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 42.0 kB
Release files / troven-0.1.0.tar.gz
| Download URL | troven-0.1.0.tar.gz |
|---|---|
| Size | 18.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
33c30bc8f482cdc8884daa1e0002bcbf01b7e3bc9dbcf448522d82fe0e2110a1
|
|
BLAKE2b-256 checksum How to use checksums |
ab4b70fc72854806a7bf14a3e0333451b0865dccffc03b68acaa90f0e84b59e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Omarchy","version":"4.0.0.r1951.g943d2fc","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / troven-0.1.0-py3-none-any.whl
| Download URL | troven-0.1.0-py3-none-any.whl |
|---|---|
| Size | 23.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c9de05cf0f4c1f2699df4352a2834ab1f4f982dc1f3933362da0c9649f29d612
|
|
BLAKE2b-256 checksum How to use checksums |
7b3af6635bd90926a2651f087af6f5816b0cf6024f9c57dfebd7d9eae0f27488
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Omarchy","version":"4.0.0.r1951.g943d2fc","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
