oss

README

OSS Monorepo

This repository hosts multiple products and shared tooling across apps, CLIs, servers, Rust crates, and Connect RPC contracts.

Repository Overview

• apps/: User-facing apps (Next.js, React Native, desktop frontends)
• cmds/: Go command tools and workflow CLIs
• crates/: Rust crates and Rust-based tooling
• servers/: Backend services and APIs
• protos/: Shared Connect RPC proto contracts
• packaging/: Package manager and release automation assets
• docs/: Canonical contracts, project indexes, and domain-level documentation

Project Catalog

Project ID	Purpose	Owned Paths	Status	Primary Docs
cargo-mono	Cargo subcommand for Rust monorepo lifecycle management, including version bump and publish orchestration.	crates/cargo-mono	active	project-cargo-mono, crates-cargo-mono-foundation
nodeup	Rust-based Node.js version manager with deterministic channel resolution, shell completions, and shim execution.	crates/nodeup	active	project-nodeup, crates-nodeup-foundation
derun	Go CLI that preserves terminal fidelity for AI-agent workflows and bridges MCP output transport.	cmds/derun	active	project-derun, cmds-derun-foundation
ttl	TTL compiler contract for task graph validation, execution, and cache-aware runtime behavior.	cmds/ttlc	active	project-ttl, cmds-ttl-foundation, cmds-ttl-language-contract
mpapp	Expo React Native app for mobile workflows with stable platform behavior and documented device capability usage.	apps/mpapp	active	project-mpapp, apps-mpapp-foundation
devkit	Next.js micro-app host platform with shared shell contracts and scaffold-first route conventions.	apps/devkit	active	project-devkit, apps-devkit-foundation
devkit-commit-tracker	Commit-level metric tracking mini app with time-series visualization and PR comparison reporting.	apps/devkit/src/apps/commit-tracker servers/commit-tracker	active (partial: collector deferred)	project-devkit-commit-tracker, apps-devkit-commit-tracker-web-app-foundation
devkit-remote-file-picker	Signed-URL upload mini app for local file or camera input with direct object-storage upload and callbacks.	apps/devkit/src/apps/remote-file-picker servers/remote-file-picker	active (partial: production adapter deferred)	project-devkit-remote-file-picker, apps-devkit-remote-file-picker-foundation
thenv	Secure .env sharing workflow across CLI, server, and Devkit web console components.	cmds/thenv servers/thenv apps/devkit/src/apps/thenv	active	project-thenv, cmds-thenv-cli-foundation, servers-thenv-server-foundation, apps-thenv-web-console-foundation
serde-feather	Size-first serialization contract split between runtime core and derive-macro crates.	crates/serde-feather crates/serde-feather-macros	active	project-serde-feather, crates-serde-feather-core-foundation, crates-serde-feather-macros-foundation
public-docs	Mintlify-based public documentation site for user-facing product and platform content.	apps/public-docs	active	project-public-docs, apps-public-docs-foundation
dexdex	Connect RPC-first orchestration platform for CLI coding agents across desktop app, control plane, worker plane, and shared proto contracts.	apps/dexdex servers/dexdex-main-server servers/dexdex-worker-server protos/dexdex/v1	active + planned (poller auto-remediation)	project-dexdex, apps-dexdex-desktop-app-foundation, servers-dexdex-main-server-foundation, servers-dexdex-worker-server-foundation, protos-dexdex-v1-contract

Documentation Contract

• docs/ is the source of truth for project contracts and implementation documents.
• Every project is defined by docs/project-<id>.md plus one or more domain contract documents.
• When ownership, interfaces, or runtime behavior changes, update the relevant docs/ contracts in the same change.
• Start from docs/README.md for the canonical documentation catalog.