contenox
Browse docs/

Build requirements

What you need depends on what you’re building. The contenox CLI needs almost nothing. This page is the one place that lists all of it, per component and per platform.

This repo (contenox) is covered by one build system:

Build systemCoversEntry point
Taskcontenox CLI, website, Go test suitesTaskfile.yml — run task --list

Baseline, for any contribution

  • Go 1.25+
  • Task (go install github.com/go-task/task/v3/cmd/task@latest)
  • git

contenox CLI

Pure Go, CGO_ENABLED=0. No C toolchain needed.

task build           # bin/contenox, host platform
task build-windows   # cross-compiled bin/contenox-windows-amd64.exe from any OS

The CLI cross-compiles cleanly to linux/darwin/windows, amd64/arm64 — see the build job matrix in .github/workflows/release.yml.

Website (contenox.com)

  • Node.js + npm
  • task website:deps, task website:dev, task website:build

Optional tooling (release/CI machinery, not needed day-to-day)

  • Rust toolchain — only for building the ACP conformance test peers (tools/acp-validator, tools/rust-sdk) used by task acp-conformance / task acp-client-e2e / task acp-host-e2e. These targets fail with a clear “set this env var” message rather than silently skipping when a peer binary isn’t built.

Maintainers: releasing

Everything above is what you need to build. Actually releasing — cutting a GitHub Release — is a separate, maintainer-only concern. See release-pipelines.md.

See also

Esc to close