onevcs
Version control and its remote host behind one host-neutral vocabulary, for agent workflows.
The review unit is a change request — GitHub maps it to a pull request, and a
later host maps it to whatever it calls the same thing. Vcs owns the repository
side (identities, sessions over an isolated worktree, preserved work);
RemoteHost owns the host side (opening a change, reading its checks, merging
it); a rules file decides, per repository, how a change publishes and what
verifies it. Everything a run does is emitted as an NDJSON event stream.
Interface-only, for now
This repository is the approved contract —
docs/contract.md— compiled. Every public type, trait, config schema, and CLI argument is final and typed; nothing behind them is implemented. Trait methods returnError::NotImplementedand every CLI subcommand exits70. Behaviour lands per-seam, and each seam brings its own real journey with it.
Install
cargo install onevcs # crates.io
pip install onevcs-cli # a prebuilt wheel, no Rust toolchain
npm install -g onevcs-cli # a prebuilt binary, no Rust toolchain
All three install the same onevcs binary. Prebuilt binaries exist for Linux
(x64, arm64), macOS (x64, arm64), and Windows (x64); every release also attaches
the archives and their .sha256 checksums for a direct download.
Use
onevcs --help
The whole command surface, and the exit codes publish reserves (1 gate or
checks failed, 2 invalid, 3 sync conflict), are declared in
docs/contract.md.
Develop
just bootstrap # from a clean clone
just check # the deterministic gate: format, clippy, tests, coverage, docs
just gate # check, plus the diff-scoped LLM-judge tier — the pre-push bar
just --list is the full index. AGENTS.md holds the durable
instructions: what the gate enforces, how releases work, and the rules that govern
changes while the crate is interface-only.
License
MIT. See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file onevcs_cli-0.1.0-py3-none-win_amd64.whl.
File metadata
- Download URL: onevcs_cli-0.1.0-py3-none-win_amd64.whl
- Upload date:
- Size: 419.2 kB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
043861b3ffe6079bf3ee98e026e28cc83a8ff22d6ba40ac0aba4b0c1f61bf7f2
|
|
| MD5 |
9b3f643d63ac340358a71cc02793e2da
|
|
| BLAKE2b-256 |
bf50b4b08eacab34732ee4b6b6cf7af7b5a49c3d8d95bdaa0ca70d8ba5bfe312
|
File details
Details for the file onevcs_cli-0.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: onevcs_cli-0.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 501.0 kB
- Tags: Python 3, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e52863b9c60bc66a0f9844cdeb3d811c0b01d18a5406a11e6b18f4a0e2a8684b
|
|
| MD5 |
0154205a06a41718d8d2d5a3f6cde93f
|
|
| BLAKE2b-256 |
d9dc0f8b5f22577daee8545f2dc828979f00c3ced361130068c469e1f613c458
|
File details
Details for the file onevcs_cli-0.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: onevcs_cli-0.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 471.8 kB
- Tags: Python 3, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e6dcc084d1b25cf95718f623155c4bd1607d366f67e4377124fc101c80bf7b1
|
|
| MD5 |
80ef273968d3a6ce2cd65fa3c558b6e8
|
|
| BLAKE2b-256 |
54cb9a2d88cabc833fc0c377951fdafd9e4624439c00a9c9fec8093f8ee6ef50
|
File details
Details for the file onevcs_cli-0.1.0-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: onevcs_cli-0.1.0-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 467.9 kB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3a5c76b930214782b9e5e7a8c4b7163acaa481e168f0aa618b582c1a7ac19cdd
|
|
| MD5 |
2624b1e75966c9374d0d072df99f74b4
|
|
| BLAKE2b-256 |
db0be804c57b0cdf33e7308c86b3cfa7c2ea0a8a18c56bac46aebf68ac9a68b9
|
File details
Details for the file onevcs_cli-0.1.0-py3-none-macosx_10_12_x86_64.whl.
File metadata
- Download URL: onevcs_cli-0.1.0-py3-none-macosx_10_12_x86_64.whl
- Upload date:
- Size: 494.2 kB
- Tags: Python 3, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e0c97b8ba28ddbab722e3bba5b74a3882a44d7158b482433c0e0cd33feb7a765
|
|
| MD5 |
a594b6d4b38bae64629e09eb0ebaa6be
|
|
| BLAKE2b-256 |
0ae43c99bcbdc2a825a0938a12f8a4ce2d1b76c3a59a9c35d612b3680c0f7b75
|
