Pyahu Toolchain

The certified developer toolchain for Pyahu Community, managed by mise.

One pinned set of CLI tools defined as a mise config. No Docker image, no manual setup. Tools are pinned per repo and resolve to the same versions on every machine, so your team's workstations stop drifting apart.

---

Prerequisites

Install mise once (see the mise install docs):

curl https://mise.run | sh

Then activate it in your shell (~/.zshrc / ~/.bashrc):

eval "$(mise activate zsh)"   # or bash

OS-level tools mise does not manage (install with your package manager): git, zsh, curl, docker, a Nerd Font, vim, and the Kafka client kcat (brew install kcat / apt install kcat).

---

Quick start

# clone or copy the configs you want, then:
mise install                       # base toolchain (shell, utils, git, editor)
mise install -E java               # add the Java overlay
MISE_ENV=java,cloud mise install   # stack several overlays

mise install reads the config in the current directory (and parent directories), downloads the pinned versions, and puts them on your PATH. Run mise ls to see what is active.

---

Where to put the config

mise reads config from your project and from a global location, merging them (closer files win). Pick what fits:

Per project (recommended, committed with your repo)

Drop mise.toml in your project root. Everyone who clones the repo gets the same tools:

curl -o mise.toml https://raw.githubusercontent.com/pyahu/toolchain/main/mise.toml
git add mise.toml && git commit -m "chore: pin toolchain with mise"

mise also accepts .mise.toml, mise/config.toml, .config/mise.toml, or .config/mise/config.toml in the project. Local, uncommitted overrides go in mise.local.toml.

Global (all your projects)

Put the base config at ~/.config/mise/config.toml to have these tools everywhere:

mkdir -p ~/.config/mise
curl -o ~/.config/mise/config.toml https://raw.githubusercontent.com/pyahu/toolchain/main/mise.toml

System-wide (all users) lives at /etc/mise/config.toml.

---

Profiles (mise environments)

The base mise.toml is the minimal set. Language and cloud overlays stack on top via MISE_ENV, which maps to the mise.<env>.toml files in this repo:

Profile	File	Activate with
base	mise.toml	mise install
java	mise.java.toml	MISE_ENV=java mise install
go	mise.go.toml	MISE_ENV=go mise install
python	mise.python.toml	MISE_ENV=python mise install
cloud	mise.cloud.toml	MISE_ENV=cloud mise install
ai	mise.ai.toml	MISE_ENV=ai mise install
everything	all of the above	MISE_ENV=java,go,python,cloud,ai mise install

Copy the overlays you use next to your mise.toml. Set MISE_ENV in your shell to make a profile sticky for a project (or use mise.toml + mise install -E <env>).

---

What's in the box

Base (mise.toml)

Tool	Purpose	Pin
starship	shell prompt	1.24
fzf	fuzzy finder	0.67
zoxide	smarter cd	0.9
ripgrep	fast grep (rg)	15
fd	fast find	10
bat	cat with syntax highlighting	0.26
eza	modern ls	0.23
btop	resource monitor	1.4
dust	disk usage	1
glow	markdown in the terminal	2
yazi	terminal file manager	25
jq	JSON processor	1.8
yq	YAML processor	4
httpie	HTTP client (http)	3.2.4
github-cli	GitHub CLI (gh)	2
delta	better git diffs	0.18
lazygit	git TUI	0.58
lazydocker	docker TUI	0.24
neovim	editor	0.11

Java (mise.java.toml): Temurin JDK 25, Maven 3, Gradle 8 (replaces SDKMAN)

Go (mise.go.toml): go 1.24, golangci-lint 2, delve (dlv), air, ko

Python (mise.python.toml): uv 0.9, ruff 0.14, ipython 9.14.1

Cloud & Kubernetes (mise.cloud.toml): kubectl 1.35, kubectx, kubens, k9s, kind, helm 4, telepresence, aws-cli 2, doctl, terraform 1.14, grpcurl, pgcli, mycli

AI (mise.ai.toml): claude-code, codex, opencode

---

Updating

Pins track current stable lines. To bump them:

mise outdated   # see what's behind
mise upgrade    # update within the pinned lines

---

License

MIT. See LICENSE.