claudecodex

charly-internals

Development internals for charly contributors — Go source map, install-plan IR, capabilities/OCI labels, vm-spec, libvirt/cloud-init renderers, cutover-policy, strict-policy, disposable, ovmf, generate-source, skill maintenance, and the agents/workflows/teams guide. Ships five agents (root-cause-analyzer, layer-validator, testing-validator, check-bed-runner, deploy-verifier).

0 on GitHubby opencharlyMITupdated 14 days agodevelopment
/

Plugin charly-internals from marketplace charly-plugins in opencharly/marketplace. Commands read from the repo's manifest — 12 days ago.

What it installs

Skills (23)

  • agents

    Multi-agent support across harnesses (Claude Code, Codex, Kimi) — sub-agents, dynamic workflows, agent teams, fresh validator sessions, and how each drives the `charly check` disposable beds. Use before authoring/invoking a sub-agent, dynamic workflow, agent team, or fresh validator session, or wiri

  • capabilities

    OCI label contract, Capabilities/BoxMetadata struct, CapabilityLabelMap completeness, LabelService round-trip, source-less deploy via `charly deploy from-box`, or adding an OCI label. Use before any of those.

  • cloud-init-renderer

    Pure renderer from VmSpec + VmCloudInit to NoCloud seed ISO (user-data + meta-data + network-config). Covers composeUsers adopt-merge, SMBIOS vs cloud_init channels, xorriso ISO emission, charly_install.strategy. Use before editing cloud-init emission paths.

  • cutover-policy

    The 'Hard Cutover by Default' policy for schema changes, API renames, and deprecations — forbidden patterns, required deliverables, rationale, examples. Use when planning or reviewing a breaking change.

  • disposable

    `disposable: true` is the ONE and ONLY authorization for autonomous destroy + rebuild via `charly update`. Use before any task involving `charly update`, live verification on rebuildable targets, or marking a VM/container deploy safe-to-nuke.

  • egress

    CUE EGRESS validation — validating (and where valuable, generating) the config files charly WRITES to a system before the bytes hit disk. Use before working on candy/plugin-fleet/egress.go, the vendored egress schemas, ValidateEgress, or adding an egress schema.

  • generate-source

    Containerfile generation: `charly box generate` output, multi-stage builds, intermediate images, the .build/ directory. Use when debugging/understanding generated Containerfiles or reading charly Go source.

  • git-workflow

    The feat/-branch, R10-gated, PR-ONLY, org-workflow-validated, never-force-push landing across the main repo, box submodules, marketplace, and the proxy-resolved sdk contract module. Use when committing, branching, pushing, opening PRs, or landing with gh; covers sync-to-upstream, fork+PR, cross-repo

  • go-quality

    Check charly's Go source for AGENTS.md compliance + code quality: golangci-lint v2, gopls, go vet, gofmt, the .go compliance checklist (R2/R3/R5), the legitimate-pattern allowlist. Use before a Go code-quality audit or lint sweep.

  • go

    Go CLI development: building the charly binary, running tests, source structure, and the SDD operationalization (spec/schema/*.cue -> `charly task cue-gen`). Use before reading/modifying charly Go source or spec/schema/*.cue.

  • install-plan

    InstallPlan is the shared deployment IR — external local/VM/pod/Kubernetes/Android targets, executor reverse-channel, host-engine steps, guest SSH, pod overlays, Kustomize, Containerfile emission, deploy wire types. Use before changing the InstallPlan or any deploy target.

  • libvirt-renderer

    Translation facade from VmSpec + LibvirtDomain to libvirt domain XML and QEMU argv — RenderDomainXML, device emission (passt, portForward, virtio-gpu), firmware plumbing, LibvirtDomain schema. Use before editing libvirt XML emission.

  • local-infra

    Go file map for the host side of `local:` + VM deploy execution — deploy_chain.go, sshconfig, hostdistro, install_ledger, builder_run, reverse_ops, deploy_ref. Use before reading/modifying those files or debugging local/VM deploy.

  • marketplace

    How the OpenCharly skill/marketplace corpus is GENERATED, refreshed, and consumed — the ownership split, regeneration command + schema prerequisite, deploy drift gate, daily refresh, per-harness caches. Use before editing the corpus or refs list.

  • ovmf

    UEFI firmware (OVMF_CODE + OVMF_VARS) path resolution for VMs — per-distro path table, per-VM NVRAM copies, secure-boot variants, the empty-strings=skip contract. Use before editing UEFI firmware resolution.

  • plugin-containerd

    The out-of-tree charly ENGINE plugin serving engine:containerd (verb:containerd / command:containerd) — every engine op delegates to container.InvokeEngineOp. `containerd` is the engine word; `nerdctl` is only the CLI binary it is driven through. Use when working with the engine:containerd provider,

  • plugin

    Authoring/modifying a charly PLUGIN — a candy with a `plugin:` block contributing Providers (verbs/kinds/deploy-targets/steps/builders/commands), its CUE schema, builtin or external. Covers the unified Provider model, per-plugin CUE-schema contract, SDK, loader.

  • repo-setup

    How the opencharly GitHub org and opencharly/.github (dotgithub) configuration and workflows drive every repository — the ONE org ruleset, the org-required `charly/pr-validator` workflow, native auto-merge, tag-on-merge CalVer, and the per-repo settings. Use when setting up a NEW repository, adding

  • root-cause-analyzer

    R1 mandatory failure analysis — the 8-step root cause analysis process. MUST be invoked before any remediation when an unexpected error, warning, or anomaly occurs.

  • skills

    Skill maintenance: when and how to update skills, root rulebooks, and README.md. Use when updating documentation, feeding back operational insights, or auditing skill coverage.

  • strict-policy

    Operationalization of AGENTS.md R1-R5 plus the RDD and ADE pillars — the engineering-discipline rules that come BEFORE runtime verification. Use when a failure/warning/anomaly surfaces, a plan rests on a high-risk unproven assumption, a pattern is about to land in a second surface, a sleep/retry/mag

  • vm-deploy-target

    The external VM deploy substrate applies InstallPlan inside a guest via the reverse-channel SSH executor — plugin-deploy-vm, VM boot/readiness, Charly delivery, nested pods, lifecycle, VmDeployState, DeployExecutor, the pluginDeployTarget/UnifiedDeployTarget seams. Use before editing VM-target deplo

  • vm-spec

    Go type reference for VmSpec and the discriminated-union source types (cloud_image | bootc | clone | imported | bootstrap | iso | container_disk) — every field, validation rules, the adopt-user decision. Use before editing VmSpec Go code or authoring vm.yml entries.

Subagents (6)

  • check-bed-runner

    Runs an existing disposable check bed to completion via `charly check run <bed>` (the full R10 sequence) and returns the VERBATIM verdict — per-step status, overall exit code, failing-step log tail. Use as the R10 acceptance executor; never summarizes away a failure.

  • deploy-verifier

    Evaluates a deployment config (a charly box OR a user deploy) and verifies expected state matches reality, returning concrete evidence-backed findings. Read-mostly: probes image artifacts and running deployments; never mutates.

  • layer-validator

    Validates charly.yml structure and candy/layer claims against the schema and the checked-out repos, returning evidence-backed verdicts. Use before editing any charly.yml.

  • pr-validator

    Blocking — the FRESH PR evaluator. Independently validates a pull request against the active harness rulebook + relevant skills and certifies its verdict (PASS/BLOCK). Uses gh_pr_status for pull-request state. Spawned with a NEW context; re-derives everything from the PR itself.

  • root-cause-analyzer

    Mandatory first response to any failure, error, warning, or anomaly (R1): 8-step root cause analysis with evidence.

  • testing-validator

    Confirms that features have been locally tested and verified (R10), inspecting the changed paths and the recorded evidence.

View source on GitHub

More from opencharly/marketplace

All 43 plugins →

charly-distros

claudecodex

Base OS images and hardware runtime — arch, fedora, debian, ubuntu, aurora, bazzite, GPU runtime (nvidia/cuda/rocm), bootc bootstrap, per-distro builders.

46 skills

0

charly-selkies

claudecodex

Self-contained skills + MCP wiring for the selkies-desktop family (Wayland desktop in a container with VNC + Chrome). Ships the chrome-devtools MCP server (port 9224).

45 skills · 1 MCP server

0

charly-coder

claudecodex

Self-contained skills + MCP wiring for charly coder/dev images (arch-coder, debian-coder, fedora-coder, ubuntu-coder, charly-arch). Ships the charly MCP server (port 18765). Bundles language runtimes (golang, rust, nodejs).

32 skills · 1 MCP server

0

charly-check

claudecodex

Live-container evaluation and probe verbs — `charly check` orchestrator + per-protocol live probes (cdp, wl, wl-overlay, dbus, vnc, spice, libvirt, record).

24 skills

0

charly-tools

claudecodex

CLI utilities and the charly binary deploy artifacts — ripgrep, himalaya, whisper, nano-pdf, summarize, ordercli, gogcli, sherpa-onnx, plus the `charly` binary deployment skill.

24 skills

0

Infrastructure services and system layers — postgresql, redis, valkey, vectorchord, k3s cluster, traefik, supervisord, tailscale, gocryptfs, virtualization, dbus-layer, tmux-layer.

22 skills

0

Similar plugins

superpowers

claudecodex

Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques

15 skills · hooks

obra/superpowers 316,836

context7

claudecodex

Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your coding agent's context.

1 MCP server

upstash/context7 64,709

Build powerful, stateful CLI interfaces for any GUI application using the cli-anything harness methodology.

5 commands

HKUDS/CLI-Anything 58,665

Automates browser interactions for web testing, form filling, screenshots, and data extraction

12 skills

vercel-labs/agent-browser 50,373

Use Alibaba Open Code Review from local Codex.

2 skills

alibaba/open-code-review 50,068

slidev

claude

Claude Code skill for creating and presenting Slidev slidedecks

1 skill

slidevjs/slidev 49,452

Maintain charly-internals?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins43 plugins