Getting started

Install once.
Use everywhere.

Requires macOS or Linux and Kujo 1.4.0 or newer. Kennel does not require Python. No administrator access is needed. The installer adds ~/.kennel/bin to Bash, Zsh and POSIX shell profiles.

Current runtime: Kujo 1.8.2

Kujo 1.8.2 is published for Linux x64/arm64, macOS x64/arm64 and Windows x64, with native archives, checksums and @kujolang/kujo-runtime@1.8.2 on npm. The Kennel native bootstrap on this page remains macOS/Linux only; its minimum is still Kujo 1.4.0. Upgrading the runtime does not upgrade Kennel or project packages. Install the runtime, then follow the separate Kennel steps below.

Wave C effect assurance and Wave D participant interoperability remain experimental companion contracts. Participant SDK packages are private/unpublished; runtime availability does not publish or stabilize them.

Install Kennel

curl -fsSLO https://kennel.kujolang.ai/install.sh
sh install.sh
. "$HOME/.kennel/env"
kennel --version

Inspect install.sh and install.kujo before running them. The shell entrypoint launches Kujo; Kujo downloads, verifies and installs the release. Use sh install.sh --no-modify-path to configure PATH yourself. Fish users can run fish_add_path ~/.kennel/bin.

Global tools

kennel tool install shipcheck
shipcheck --help
kennel tool list
kennel tool update shipcheck
kennel tool remove shipcheck

Tools run from your current directory. Installation records exact versions and checksums and protects existing commands. Exact versions stay pinned; use kennel tool install shipcheck@1.0.0 to select one.

Project dependencies

kennel init --name my-project
kennel add ability
kennel install

Project dependencies stay inside the project and do not add global commands.

Keep Kennel updated

kennel self update

A failed update preserves your current client and tools. Pin a client with kennel self update --version VERSION.

Publish a tool

Enrolled official projects publish through actual GitHub Releases. Keep kennel.toml and release versions aligned; the registry checks for releases every 15 minutes. Declare commands:

[bin]
my-tool = "main.kujo"

Entries may be .kujo files or executable sh, Bash or Python scripts with supported shebangs. A particular third-party script can require its own interpreter; Kennel itself does not. Historical packages can use [kujo].entry. Libraries use kennel add.

Agent City uses its own installer

Agent City is a local workspace for agent tasks, review, and replay in a pixel-art city. Its installer supplies the application and pinned Kujo dependencies for macOS and Linux.

Agent City is not a Kennel package. Use its versioned installer rather than kennel add agent-city or kennel tool install agent-city:

curl --proto '=https' --tlsv1.2 -fsSL https://github.com/kujolang/agent-city/releases/download/v0.2.0/install.sh | sh

Configure your own Ollama or Codex connection after installation. Workcell execution and VideoOps rendering need a compatible container engine and explicit permission. See the Agent City setup guide and 0.2.0 release.