CastCodes

CastCodes is a local-first AI coding workspace powered by Coven. It is the product users open: terminal and editor substrate, agent panels and lanes, local project context, and review workflows in one desktop workspace.

Coven powers CastCodes with project-scoped harness sessions, local runtime boundaries, logs, artifacts, handoffs, policy, and orchestration. The public CastCodes build remains local-only by default; Coven is invisible until you need to trust how work was launched, recorded, verified, or cleaned up.

This repository is still a staged external rebrand. Internal Rust crate/module names such as warp_core, warpui, and warp_terminal remain compatibility details for now.

Current Scope

• Public app name: CastCodes
• Public binary/package slug: cast-codes
• Public app ID: dev.castcodes.CastCodes
• Public URL scheme: castcodes://
• Local terminal and code workflows are in scope.
• Coven-powered agent sessions are the core product direction.
• Cast Agent is the CastCodes integration layer for Coven runtime data and agent panel behavior.

The public CastCodes build is local-only by default. It does not include sign-in, hosted telemetry, hosted crash reporting, billing, shared sessions, upstream release feeds, or upstream feedback flows. Feedback links route to this fork's GitHub issue tracker.

Coven-Powered Workspace

CastCodes should make autonomous coding work visible and reviewable without asking users to learn the whole OpenCoven history first:

• Run Codex, Claude Code, and future harnesses as visible project-scoped lanes.
• Inspect their work through terminal output, workspace context, changed files, and diffs.
• Preserve context, logs, artifacts, and handoff packets through Coven-managed session records.
• Run verification gates and show results before merge, PR, archive, or cleanup actions.
• Keep approvals explicit for actions that push, merge, publish, delete, or change external state.

See docs/COVEN-POWERED-CASTCODES.md for the direction doc and CastCodes parity milestones.

Install on Linux

Prebuilt CastCodes packages for Linux are published as GitHub release assets at github.com/OpenCoven/cast-codes/releases/latest. The OSS channel currently publishes x86_64 builds in four formats; each asset ships with a matching .sha256 checksum file.

Distribution	Asset
Debian, Ubuntu, derivatives	cast-codes_<version>_amd64.deb
Fedora, RHEL, derivatives	cast-codes-v<version>-1.x86_64.rpm
Arch Linux, derivatives	cast-codes-v<version>-1-x86_64.pkg.tar.zst
Any glibc-based distro	CastCodes-x86_64.AppImage

A CLI-only variant of each package (cast-codes-cli-...) is also published for headless installs.

Verify the download

Download both the package and its .sha256 file, then compare the checksum:

expected="$(awk '{print $1}' cast-codes_<version>_amd64.deb.sha256)"
actual="$(sha256sum cast-codes_<version>_amd64.deb | awk '{print $1}')"
test "$actual" = "$expected"

Debian / Ubuntu

sudo apt install ./cast-codes_<version>_amd64.deb

Fedora / RHEL

sudo dnf install ./cast-codes-v<version>-1.x86_64.rpm

Arch Linux

sudo pacman -U cast-codes-v<version>-1-x86_64.pkg.tar.zst

Packages install the binary to /opt/castcodes/cast-codes/ and register a cast-codes launcher and dev.castcodes.CastCodes.desktop entry.

AppImage

The AppImage runs without installation on most modern glibc-based distros:

chmod +x CastCodes-x86_64.AppImage
./CastCodes-x86_64.AppImage

If the AppImage fails to start, install runtime dependencies first — see Build from source on Linux below for the relevant packages, or run ./script/linux/install_runtime_deps from a repository checkout.

Build from source on Linux

From a checkout, install build and runtime dependencies, then run the app:

./script/linux/install_runtime_deps
./script/run

The dependency installer currently provisions Debian-family systems (apt-get); on other distros, install the equivalent packages by hand — see script/linux/install_build_deps and script/linux/install_runtime_deps for the full lists.

Build

./script/run

For a static packaging check:

./script/check_ai_attribution
./script/check_rebrand
cargo check -p warp-app --bin cast-codes --features gui
./script/bundle --channel oss --check-only

Repository Notes

This is a staged external rebrand. Do not run blind repository-wide replacements; many remaining internal names are intentional compatibility boundaries.

Use the rebrand guard before shipping public-surface changes:

./script/check_ai_attribution
./script/check_rebrand

./script/check_ai_attribution prevents generated-by/model-credit footers from entering specs, docs, prompts, and public artifacts. Mentions of supported AI tools are still allowed when they describe real product behavior.

Contributing

See CONTRIBUTING.md. Security reporting guidance is in SECURITY.md, and community expectations are in CODE_OF_CONDUCT.md.

License

CastCodes preserves the upstream license structure. See LICENSE-AGPL, LICENSE-MIT, and related license files in this repository.