cyphra-cli is the public command-line interface, workflow DSL, and terminal application for the Roadscript platform.
It demonstrates the developer-facing application layer around Roadscript, including command execution, workflow authoring, local tooling, and package integration, while the core watermarking engine remains private.
Roadscript is a C++ platform for content authentication and verifiable digital media. It combines invisible watermarking, workflow automation, and developer tooling into a modular architecture for building authenticity-aware applications.
This repository is part of the Roadscript public/private repository ecosystem:
| Repository | Visibility | Purpose |
|---|---|---|
roadscript-docs |
Public | Public overview, architecture notes, repository boundaries, and development milestones. |
cyphra-cli |
Public | Standalone CLI, workflow DSL, interactive terminal UI, examples, tests, and tooling. |
roadscript-site |
Public | Public website and sample-driven demo surface. |
roadscript-engine |
Private | Private C++ core package consumed by the application layer. |
cyphra-cli focuses on developer-facing workflow surfaces, command orchestration, examples, and application-layer tests. It does not include the private Engine source.
This repository contains:
- the
rsecommand-line application - a C++ command-line frontend
- the Cyphra workflow DSL
- an interactive terminal UI
- runnable workflow examples
- CLI regression tests and fixtures
- evaluation and reporting tools
The repository should be read as a public engineering artifact and a working application shell around the private Engine package. It is not presented as a finished end-user product release.
The CLI is built as a consumer of an installed CMake package:
find_package(RoadscriptEngine CONFIG REQUIRED)
target_link_libraries(rse PRIVATE Roadscript::rsengine)The private roadscript-engine repository owns the core C++ engine implementation. Its public integration boundary is the installed RoadscriptEngine CMake package and the exported Roadscript::rsengine target.
This split is intentional:
roadscript-engineowns the private core package and implementation details.cyphra-cliowns the public CLI, workflow DSL, local TUI prototype, tests, examples, and tooling.- The application layer consumes the Engine through a package boundary instead of directly bundling Engine source.
- Public code demonstrates application architecture without exposing private Engine internals.
Configure the project with an installed RoadscriptEngine package:
cmake -S . -B build \
-DCMAKE_BUILD_TYPE=Release \
-DRoadscriptEngine_DIR=/path/to/RoadscriptEngine/cmake
cmake --build buildThe resulting Cyphra CLI binary is expected at:
build/rse
./build/rse --help
./build/rse run examples/classic_roundtrip.rsx --dry-runThe example workflow is designed to exercise the CLI and DSL planning path without requiring a production backend or public Engine source.
.
├── apps/
│ ├── cli/ # C++ command-line application
│ └── tui/ # Local TUI prototype
├── docs/ # CLI, DSL, and tooling documentation
├── examples/ # Example workflow scripts
├── tests/ # CLI-level regression tests and fixtures
├── tools/ # Evaluation and reporting helpers
├── CMakeLists.txt
└── README.md
docs/cli.md— command-line usage and command surfacedocs/dsl.md— workflow DSL concepts and examplesdocs/corpus_eval.md— corpus evaluation tooling notes
- Actively developed
- Public application-layer repository
- Built against the private
RoadscriptEnginepackage - Standalone CMake consumer project
- Workflow examples and regression tests
- Interactive terminal UI
This repository is published to demonstrate Cyphra CLI’s application architecture, tooling, tests, examples, and package-consumer design. It should not be interpreted as a complete commercial release.
This repository showcases:
- modern C++ application architecture
- package-based dependency management with CMake
- CLI and terminal UI design
- workflow DSL implementation
- application-layer testing
- developer tooling and documentation
- clean separation between public application code and a private engine package
For the full project map and architecture context, start with roadscript-docs.
Cyphra CLI is designed around several engineering principles:
- modular application architecture
- package-oriented dependency boundaries
- reproducible command-line workflows
- clear separation between public tooling and private implementation
- developer-first ergonomics
roadscript-docs— public overview, architecture notes, and repository boundaries.roadscript-site— public website and sample-driven demo surface.roadscript-engine— private C++ core package consumed throughRoadscriptEngineandRoadscript::rsengine.
License information will be added before external reuse. For now, this repository is published for portfolio and project review.