Skip to content

Submit codeherd to mise official registry #15

Description

@xico42

Goal

Register codeherd in the mise official registry so users can install it with mise use codeherd@<version> instead of mise use github:xico42/codeherd@<version>.

Prerequisites

Blocked on #13 (release pipeline). Cannot submit until:

  • At least one public GitHub release exists, tagged vX.Y.Z.
  • Release assets follow OS+arch naming so mise's autodetection works (e.g. ch-<version>-linux-amd64.tar.gz, ch-<version>-darwin-arm64.tar.gz).
  • Archive root contains the ch binary at a predictable path.
  • Raw github backend install works end-to-end: mise use github:xico42/codeherd@<version> resolves, downloads, and runs.

Submission steps

  1. Verify name availability in jdx/mise:registry/ — confirmed free as of 2026-05-28 for both codeherd.toml and ch.toml. Going with codeherd (descriptive, no squat risk).
  2. Fork jdx/mise.
  3. Add registry/codeherd.toml:
    backends = ["github:xico42/codeherd"]
    description = "CLI for parallel agentic coding sessions"
    os = ["linux", "macos"]
    test = { cmd = "ch --version", expected = "{{version}}" }
  4. Open PR against jdx/mise:main. Reference the codeherd repo, link to a successful release, and mention the tier-1 backend (github).
  5. Address review feedback. Common asks: bin name override if ch collides with another tool's binary on PATH, asset pattern override if autodetection picks the wrong archive.
  6. Merge → users can mise use codeherd@<version>.

Tier

Tier 1 (github backend). Per mise registry policy, tier-1 submissions are routinely accepted when the release format is mise-friendly.

Acceptance criteria

  • registry/codeherd.toml merged into jdx/mise:main.
  • mise use codeherd@<latest> installs and ch --version reports the correct version on linux-amd64, linux-arm64, darwin-amd64, darwin-arm64.
  • README install snippet updated to mention mise use codeherd@latest (drop the raw github: form once registry is live).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions