agent-kit

Versioned source for the JorisJonkers-dev agent renderer, installer kit, and portable runner runtime templates.

What It Is

agent-kit owns the checked-in agent templates, generated Claude/Codex surfaces, council bundle, installer artifacts, and runner runtime manifests used by JorisJonkers-dev automation.

Local Use

uv sync --frozen
uv run python render-agent-kit.py --check
uv run python render-agent-kit.py --doctor
uv run ruff check .
uv run mypy
uv run pytest
uv run python scripts/validate_manifest.py
uv run python scripts/render_registry.py --check

Use uv run python render-agent-kit.py --write only when intentionally updating checked-in generated surfaces from templates/ or council/. Use scripts/build-runtime-package.sh v0.0.0-local dist to build the runtime-home bundle locally.

Workstation Setup

./installer/setup-workstation.sh --check     # report only
./installer/setup-workstation.sh             # install/upgrade everything

Claude Code and Codex at their latest releases, every plugin, the language servers those plugins drive, the MCP fleet, and the first-party skills. The script is generated from registry/estate-tooling.yaml -- see docs/SETUP.md.

Docs

• docs/SETUP.md: workstation setup, credentials, exit codes.
• docs/REGISTRY.md: the one file to edit to add a skill, plugin, CLI or MCP server to every surface at once.
• docs/HERMES.md: getting a registry entry onto the in-cluster gateway, and verifying it landed.
• docs/MEMORY.md: what replaces the retired knowledge base.
• docs/CLOUD.md: the same setup in a Claude Code cloud environment, from the two files in cloud/.

The estate ships no agent hooks. setup-workstation.sh purges the retired knowledge hooks from a machine that still has them, on every run.

Layout

• registry/estate-tooling.yaml: the tooling registry (hand-edited).
• installer/setup-workstation.sh, registry/generated/hermes/: generated from it by scripts/render_registry.py. Never hand-edit these.
• skills/: first-party multi-file skills copied onto a surface.
• templates/repo/: source templates for .claude, .codex, .agents, and project Spec Kit seed payload.
• templates/runner-runtime/: source templates for runner runtime artifacts.
• installer/: setup-workstation.sh and setup-container.sh, generated as above, plus the hand-written port-forward-agent.sh and cloud-session.sh they source.
• cloud/: the setup script and environment variables pasted into a Claude Code cloud environment.
• runner-manifests/: rendered runtime package artifacts and validation fixtures.
• council/: council driver, prompts, schemas, and default config.
• manifest.yaml: managed path, checksum, parity, and artifact ledger.

Install

From a checkout:

./installer/setup-workstation.sh

Or fetched over HTTP; outside a checkout it fetches the kit bundle of the same release and runs that:

curl -fsSL https://assets.jorisjonkers.dev/setup-workstation.sh | bash

--uninstall removes what a machine set up by the retired install.sh / install-agents.sh wrote (base skills, Spec Kit commands/skills, their MCP entries) and purges the retired knowledge hooks. See PORTABILITY.md.

Links

• Organization profile
• Security policy
• Changelog
• License

Copyright (c) Joris Jonkers. Source available for viewing only; use, copying, modification, redistribution, deployment, or reuse is not licensed. See LICENSE.